#110496# Merge from cws_srx645_canvas01: first working version of XCanvas UNO components, for now consisting of javacanvas.uno.jar, vclcanvas.uno and directxcanvas.uno (windows only)

4 files changed, 705 insertions, 0 deletions

diff --git a/canvas/inc/canvas/canvastools.hxx b/canvas/inc/canvas/canvastools.hxx
new file mode 100644
index 000000000000..ff7cc931abfa
--- /dev/null
+++ b/canvas/inc/canvas/canvastools.hxx
@@ -0,0 +1,322 @@
+/*************************************************************************
+ *
+ *  $RCSfile: canvastools.hxx,v $
+ *
+ *  $Revision: 1.2 $
+ *
+ *  last change: $Author: thb $ $Date: 2004-03-18 10:38:24 $
+ *
+ *  The Contents of this file are made available subject to the terms of
+ *  either of the following licenses
+ *
+ *         - GNU Lesser General Public License Version 2.1
+ *         - Sun Industry Standards Source License Version 1.1
+ *
+ *  Sun Microsystems Inc., October, 2000
+ *
+ *  GNU Lesser General Public License Version 2.1
+ *  =============================================
+ *  Copyright 2000 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
+ *
+ *
+ *  Sun Industry Standards Source License Version 1.1
+ *  =================================================
+ *  The contents of this file are subject to the Sun Industry Standards
+ *  Source License Version 1.1 (the "License"); You may not use this file
+ *  except in compliance with the License. You may obtain a copy of the
+ *  License at http://www.openoffice.org/license.html.
+ *
+ *  Software provided under this License is provided on an "AS IS" basis,
+ *  WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
+ *  WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
+ *  MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
+ *  See the License for the specific provisions governing your rights and
+ *  obligations concerning the Software.
+ *
+ *  The Initial Developer of the Original Code is: Sun Microsystems, Inc.
+ *
+ *  Copyright: 2000 by Sun Microsystems, Inc.
+ *
+ *  All Rights Reserved.
+ *
+ *  Contributor(s): _______________________________________
+ *
+ *
+ ************************************************************************/
+
+#ifndef _CANVAS_CANVASTOOLS_HXX
+#define _CANVAS_CANVASTOOLS_HXX
+
+#ifndef _COM_SUN_STAR_UNO_REFERENCE_HXX_
+#include <com/sun/star/uno/Reference.hxx>
+#endif
+#ifndef _COM_SUN_STAR_UNO_SEQUENCE_HXX_
+#include <com/sun/star/uno/Sequence.hxx>
+#endif
+#ifndef _COM_SUN_STAR_UNO_RUNTIMEEXCEPTION_HDL_
+#include <com/sun/star/uno/RuntimeException.hdl>
+#endif
+#ifndef _COM_SUN_STAR_LANG_ILLEGALARGUMENTEXCEPTION_HPP_
+#include <com/sun/star/lang/IllegalArgumentException.hpp>
+#endif
+
+#include <limits>
+#include <algorithm>
+
+
+namespace basegfx
+{
+    class B2DHomMatrix;
+    class B2DRange;
+}
+
+namespace drafts { namespace com { namespace sun { namespace star { namespace geometry
+{
+    struct AffineMatrix2D;
+} } } } }
+
+namespace drafts { namespace com { namespace sun { namespace star { namespace rendering
+{
+    struct RenderState;
+    struct ViewState;
+    class  XCanvas;
+} } } } }
+
+
+namespace canvas
+{
+    namespace tools
+    {
+        // View- and RenderState utilities
+        // ===================================================================
+
+        ::drafts::com::sun::star::rendering::RenderState&
+            initRenderState( ::drafts::com::sun::star::rendering::RenderState&                      renderState );
+
+        ::drafts::com::sun::star::rendering::ViewState&
+            initViewState( ::drafts::com::sun::star::rendering::ViewState&                          viewState );
+
+        ::basegfx::B2DHomMatrix&
+            getViewStateTransform( ::basegfx::B2DHomMatrix&                                         transform,
+                                   const ::drafts::com::sun::star::rendering::ViewState&            viewState );
+
+        ::drafts::com::sun::star::rendering::ViewState&
+            setViewStateTransform( ::drafts::com::sun::star::rendering::ViewState&                  viewState,
+                                   const ::basegfx::B2DHomMatrix&                                   transform );
+
+        ::basegfx::B2DHomMatrix&
+            getRenderStateTransform( ::basegfx::B2DHomMatrix&                                       transform,
+                                     const ::drafts::com::sun::star::rendering::RenderState&        renderState );
+
+        ::drafts::com::sun::star::rendering::RenderState&
+            setRenderStateTransform( ::drafts::com::sun::star::rendering::RenderState&              renderState,
+                                     const ::basegfx::B2DHomMatrix&                                 transform );
+
+        ::drafts::com::sun::star::rendering::ViewState&
+            appendToViewState( ::drafts::com::sun::star::rendering::ViewState&                      viewState,
+                               const ::basegfx::B2DHomMatrix&                                       transform );
+
+        ::drafts::com::sun::star::rendering::RenderState&
+            appendToRenderState( ::drafts::com::sun::star::rendering::RenderState&                  renderState,
+                                 const ::basegfx::B2DHomMatrix&                                     transform );
+
+        ::drafts::com::sun::star::rendering::ViewState&
+            prependToViewState( ::drafts::com::sun::star::rendering::ViewState&                     viewState,
+                                const ::basegfx::B2DHomMatrix&                                      transform );
+
+        ::drafts::com::sun::star::rendering::RenderState&
+            prependToRenderState( ::drafts::com::sun::star::rendering::RenderState&                 renderState,
+                                  const ::basegfx::B2DHomMatrix&                                    transform );
+
+        ::basegfx::B2DHomMatrix&
+            mergeViewAndRenderTransform( ::basegfx::B2DHomMatrix&                                   transform,
+                                         const ::drafts::com::sun::star::rendering::ViewState&      viewState,
+                                         const ::drafts::com::sun::star::rendering::RenderState&    renderState );
+
+        ::drafts::com::sun::star::rendering::ViewState&
+            mergeViewAndRenderState( ::drafts::com::sun::star::rendering::ViewState&                resultViewState,
+                                     const ::drafts::com::sun::star::rendering::ViewState&          viewState,
+                                     const ::drafts::com::sun::star::rendering::RenderState&        renderState,
+                                     const ::com::sun::star::uno::Reference<
+                                         ::drafts::com::sun::star::rendering::XCanvas >                 xCanvas );
+
+        bool operator==( const ::drafts::com::sun::star::rendering::RenderState&                    rLHS,
+                         const ::drafts::com::sun::star::rendering::RenderState&                    rRHS );
+
+        bool operator==( const ::drafts::com::sun::star::rendering::ViewState&                      rLHS,
+                         const ::drafts::com::sun::star::rendering::ViewState&                      rRHS );
+
+
+        // Matrix utilities
+        // ===================================================================
+
+        ::drafts::com::sun::star::geometry::AffineMatrix2D&
+            setIdentityAffineMatrix2D( ::drafts::com::sun::star::geometry::AffineMatrix2D&          matrix );
+
+
+        // Special utilities
+        // ===================================================================
+
+        /** Calc the bounding rectangle of a transformed rectangle.
+
+            The method applies the given transformation to the
+            specified input rectangle, and returns the bounding box of
+            the resulting output area.
+
+            @param o_Rect
+            Output rectangle
+
+            @param i_Rect
+            Input rectangle
+
+            @param i_Transformation
+            Transformation to apply to the input rectangle
+
+            @see calcRectToRectTransform()
+         */
+        ::basegfx::B2DRange& calcTransformedRectBounds( ::basegfx::B2DRange&            o_Rect,
+                                                        const ::basegfx::B2DRange&      i_Rect,
+                                                        const ::basegfx::B2DHomMatrix&  i_Transformation );
+
+        /** Calc a transform that maps one rectangle on top of
+            another.
+
+            The method is a kissing cousin to
+            calcTransformedRectBounds(). It can be used to modify the
+            given transformation matrix, such that it transforms the
+            given input rectangle to the given output rectangle,
+            changing only translation and scale (if necessary). Thus,
+            if you've calculated an output rectangle via
+            calcTransformedRectBounds(), you can move and scale that
+            rectangle as you like, and have this method calculate the
+            required total transformation for it.
+
+            @param o_transform
+            Output parameter, to receive the resulting transformation
+            matrix.
+
+            @param i_destRect
+            Input parameter, specifies the requested destination
+            rectangle. The resulting transformation will exactly map
+            the source rectangle to the destination rectangle.
+
+            @param i_srcRect
+            Input parameter, specifies the original source
+            rectangle. The resulting transformation will exactly map
+            the source rectangle to the destination rectangle.
+
+            @param i_transformation
+            The original transformation matrix. This is changed with
+            translations and scalings (if necessary), to exactly map
+            the source rectangle to the destination rectangle.
+
+            @return a reference to the resulting transformation matrix
+
+            @see calcTransformedRectBounds()
+        */
+        ::basegfx::B2DHomMatrix& calcRectToRectTransform( ::basegfx::B2DHomMatrix&          o_transform,
+                                                          const ::basegfx::B2DRange&        i_destRect,
+                                                          const ::basegfx::B2DRange&        i_srcRect,
+                                                          const ::basegfx::B2DHomMatrix&    i_transformation );
+
+        /** Calc a transform that maps the upper, left corner of a
+             rectangle to the origin.
+
+            The method is a specialized version of
+            calcRectToRectTransform(), mapping the input rectangle's
+            the upper, left corner to the origin, and leaving the size
+            untouched.
+
+            @param o_transform
+            Output parameter, to receive the resulting transformation
+            matrix.
+
+            @param i_srcRect
+            Input parameter, specifies the original source
+            rectangle. The resulting transformation will exactly map
+            the source rectangle's upper, left corner to the origin.
+
+            @param i_transformation
+            The original transformation matrix. This is changed with
+            translations (if necessary), to exactly map the source
+            rectangle to the origin.
+
+            @return a reference to the resulting transformation matrix
+
+            @see calcRectToRectTransform()
+            @see calcTransformedRectBounds()
+        */
+        ::basegfx::B2DHomMatrix& calcRectToOriginTransform( ::basegfx::B2DHomMatrix&        o_transform,
+                                                            const ::basegfx::B2DRange&      i_srcRect,
+                                                            const ::basegfx::B2DHomMatrix&  i_transformation );
+
+        /** Range checker, which throws ::com::sun::star::lang::IllegalArgument exception, when
+            range is violated
+        */
+        template< typename NumType > inline void checkRange( NumType arg, NumType lowerBound, NumType upperBound )
+        {
+            if( arg < lowerBound ||
+                arg > upperBound )
+            {
+                throw ::com::sun::star::lang::IllegalArgumentException();
+            }
+        }
+
+        /** Range checker, which throws ::com::sun::star::lang::IndexOutOfBounds exception, when
+            index range is violated
+        */
+        template< typename NumType > inline void checkIndexRange( NumType arg, NumType lowerBound, NumType upperBound )
+        {
+            if( arg < lowerBound ||
+                arg > upperBound )
+            {
+                throw ::com::sun::star::lang::IndexOutOfBoundsException();
+            }
+        }
+
+        // BEWARE: don't currently use with float or double, Solaris
+        // STLport's numeric_limits bark on that (unresolved
+        // externals)
+
+        // Modeled closely after boost::numeric_cast, only that we
+        // issue some trace output here and throw a RuntimeException
+        template< typename Target, typename Source > inline Target numeric_cast( Source arg )
+        {
+            // typedefs abbreviating respective trait classes
+            typedef ::std::numeric_limits< Source > SourceLimits;
+            typedef ::std::numeric_limits< Target > TargetLimits;
+
+            if( ( arg<0 && !TargetLimits::is_signed) ||                     // loosing the sign here
+                ( SourceLimits::is_signed && arg<TargetLimits::min()) ||    // underflow will happen
+                ( arg>TargetLimits::max() ) )                               // overflow will happen
+            {
+#ifdef VERBOSE
+                OSL_TRACE("numeric_cast detected data loss");
+#endif
+                throw ::com::sun::star::uno::RuntimeException(
+                    ::rtl::OUString(RTL_CONSTASCII_USTRINGPARAM( "numeric_cast detected data loss" )),
+                    NULL );
+            }
+
+            return static_cast<Target>(arg);
+        }
+
+    }
+}
+
+#endif /* _CANVAS_CANVASTOOLS_HXX */
diff --git a/canvas/inc/canvas/elapsedtime.hxx b/canvas/inc/canvas/elapsedtime.hxx
new file mode 100644
index 000000000000..fcb008527f25
--- /dev/null
+++ b/canvas/inc/canvas/elapsedtime.hxx
@@ -0,0 +1,114 @@
+/*************************************************************************
+ *
+ *  $RCSfile: elapsedtime.hxx,v $
+ *
+ *  $Revision: 1.2 $
+ *
+ *  last change: $Author: thb $ $Date: 2004-03-18 10:38:25 $
+ *
+ *  The Contents of this file are made available subject to the terms of
+ *  either of the following licenses
+ *
+ *         - GNU Lesser General Public License Version 2.1
+ *         - Sun Industry Standards Source License Version 1.1
+ *
+ *  Sun Microsystems Inc., October, 2000
+ *
+ *  GNU Lesser General Public License Version 2.1
+ *  =============================================
+ *  Copyright 2000 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
+ *
+ *
+ *  Sun Industry Standards Source License Version 1.1
+ *  =================================================
+ *  The contents of this file are subject to the Sun Industry Standards
+ *  Source License Version 1.1 (the "License"); You may not use this file
+ *  except in compliance with the License. You may obtain a copy of the
+ *  License at http://www.openoffice.org/license.html.
+ *
+ *  Software provided under this License is provided on an "AS IS" basis,
+ *  WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
+ *  WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
+ *  MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
+ *  See the License for the specific provisions governing your rights and
+ *  obligations concerning the Software.
+ *
+ *  The Initial Developer of the Original Code is: Sun Microsystems, Inc.
+ *
+ *  Copyright: 2000 by Sun Microsystems, Inc.
+ *
+ *  All Rights Reserved.
+ *
+ *  Contributor(s): _______________________________________
+ *
+ *
+ ************************************************************************/
+
+#ifndef _CANVAS_ELAPSEDTIME_HXX
+#define _CANVAS_ELAPSEDTIME_HXX
+
+#ifndef _SAL_TYPES_H_
+#include <sal/types.h>
+#endif
+
+namespace canvas
+{
+    namespace tools
+    {
+        /** Calculate elapsed time
+         */
+        class ElapsedTime
+        {
+        public:
+            /** Create a new ElapsedTime object
+
+                The moment of construction starts the time
+                measurement. That means, a subsequent getElapsedTime()
+                call will return the time difference between object
+                creation and getElapsedTime() call.
+             */
+            ElapsedTime();
+
+            /** Reset the time
+
+                The instance of the reset() call starts the time
+                measurement from scratch. That means, a subsequent
+                getElapsedTime() call will return the time difference
+                between reset() and getElapsedTime() call.
+             */
+            void reset();
+
+            /** Query the elapsed time
+
+                This method returns the elapsed time in seconds
+                between either the construction of this object, or the
+                last reset() call, if any.
+
+                @return the elapsed time in seconds.
+             */
+            double getElapsedTime();
+
+        private:
+            sal_uInt64  mnStartTime;    // implementation-dependent start time representation
+            double      mfTimeFactor;   // correction factor to get the time in seconds from mnStartTime
+        };
+
+    }
+}
+
+#endif /* _CANVAS_ELAPSEDTIME_HXX */
diff --git a/canvas/inc/canvas/vclwrapper.hxx b/canvas/inc/canvas/vclwrapper.hxx
new file mode 100644
index 000000000000..a1bcaf58688a
--- /dev/null
+++ b/canvas/inc/canvas/vclwrapper.hxx
@@ -0,0 +1,197 @@
+/*************************************************************************
+ *
+ *  $RCSfile: vclwrapper.hxx,v $
+ *
+ *  $Revision: 1.2 $
+ *
+ *  last change: $Author: thb $ $Date: 2004-03-18 10:38:25 $
+ *
+ *  The Contents of this file are made available subject to the terms of
+ *  either of the following licenses
+ *
+ *         - GNU Lesser General Public License Version 2.1
+ *         - Sun Industry Standards Source License Version 1.1
+ *
+ *  Sun Microsystems Inc., October, 2000
+ *
+ *  GNU Lesser General Public License Version 2.1
+ *  =============================================
+ *  Copyright 2000 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
+ *
+ *
+ *  Sun Industry Standards Source License Version 1.1
+ *  =================================================
+ *  The contents of this file are subject to the Sun Industry Standards
+ *  Source License Version 1.1 (the "License"); You may not use this file
+ *  except in compliance with the License. You may obtain a copy of the
+ *  License at http://www.openoffice.org/license.html.
+ *
+ *  Software provided under this License is provided on an "AS IS" basis,
+ *  WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
+ *  WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
+ *  MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
+ *  See the License for the specific provisions governing your rights and
+ *  obligations concerning the Software.
+ *
+ *  The Initial Developer of the Original Code is: Sun Microsystems, Inc.
+ *
+ *  Copyright: 2000 by Sun Microsystems, Inc.
+ *
+ *  All Rights Reserved.
+ *
+ *  Contributor(s): _______________________________________
+ *
+ *
+ ************************************************************************/
+
+#ifndef _CANVAS_VCLWRAPPER_HXX
+#define _CANVAS_VCLWRAPPER_HXX
+
+#ifndef _OSL_MUTEX_HXX_
+#include <osl/mutex.hxx>
+#endif
+#ifndef _VOS_MUTEX_HXX_
+#include <vos/mutex.hxx>
+#endif
+#ifndef _SV_SVAPP_HXX
+#include <vcl/svapp.hxx>
+#endif
+
+
+namespace canvas
+{
+    namespace vcltools
+    {
+        /** This helper template wraps VCL objects, and protects
+            object deletion with the Solar mutex. All other operations
+            are unprotected, this must be handled by client code.
+
+            The reason for this template is the fact that VCL objects
+            hold by value in uno::Reference-handled classes are
+            deleted without having the chance to get inbetween and
+            lock the solar mutex.
+
+            This template handles that problem transparently, the only
+            inconvenience is the fact that object member access now
+            has to be performed via operator->, since . is not
+            overloadable.
+
+            Otherwise, the template preserves the value semantics of
+            the wrapped object, that is, copy operations are performed
+            not by copying pointers, but by copying the underlying
+            object. This includes constness, i.e. on a const
+            VCLObject, only const methods of the wrapped object can be
+            called. Simply imagine this to be a value object of type
+            "template argument", with the only peculiarity that
+            member/method access is performed by operator-> instead of
+            the non-existing "operator.".
+         */
+        template< class _Wrappee > class VCLObject
+        {
+        public:
+            typedef _Wrappee Wrappee;
+
+            VCLObject() :
+                mpWrappee( new Wrappee() )
+            {
+            }
+
+            // no explicit here. VCLObjects should be freely
+            // constructible with Wrappees, and AFAIK there is no other
+            // implicit conversion path that could cause harm here
+            VCLObject( Wrappee* pWrappee ) :
+                mpWrappee( pWrappee )
+            {
+            }
+
+            // This object has value semantics, thus, forward copy
+            // to wrappee
+            VCLObject( const VCLObject& rOrig )
+            {
+                if( rOrig.mpWrappee )
+                    mpWrappee = new Wrappee( *rOrig.mpWrappee );
+                else
+                    mpWrappee = NULL;
+            }
+
+            // This object has value semantics, thus, forward copy
+            // to wrappee
+            VCLObject( const Wrappee& rOrig ) :
+                mpWrappee( new Wrappee( rOrig ) )
+            {
+            }
+
+            // This object has value semantics, thus, forward
+            // assignment to wrappee
+            VCLObject& operator=( const VCLObject& rhs )
+            {
+                if( mpWrappee )
+                {
+                    if( rhs.mpWrappee )
+                        *mpWrappee = *rhs.mpWrappee;
+                }
+                else
+                {
+                    if( rhs.mpWrappee )
+                        mpWrappee = new Wrappee( *rhs.mpWrappee );
+                }
+
+                return *this;
+            }
+
+            ~VCLObject()
+            {
+                // This here is the whole purpose of the template:
+                // protecting object deletion with the solar mutex
+                ::vos::OGuard aGuard( Application::GetSolarMutex() );
+
+                if( mpWrappee )
+                    delete mpWrappee;
+            }
+
+            Wrappee*        operator->() { return mpWrappee; }
+            const Wrappee*  operator->() const { return mpWrappee; }
+
+            Wrappee&        operator*() { return *mpWrappee; }
+            const Wrappee&  operator*() const { return *mpWrappee; }
+
+            bool            operator==( const Wrappee& rhs ) const
+            {
+                if( mpWrappee )
+                    return *const_cast<const Wrappee*>(mpWrappee) == rhs; // force operator==() const call on wrappee
+                else
+                    return mpWrappee == rhs.mpWrappee; // handle both-sides-null correctly
+            }
+
+            bool            operator==( const Wrappee& rhs )
+            {
+                if( mpWrappee )
+                    return *mpWrappee == rhs;
+                else
+                    return mpWrappee == rhs.mpWrappee; // handle both-sides-null correctly
+            }
+
+        private:
+
+            Wrappee* mpWrappee;
+        };
+
+    }
+}
+
+#endif /* _CANVAS_VCLWRAPPER_HXX */
diff --git a/canvas/inc/canvas/verbosetrace.hxx b/canvas/inc/canvas/verbosetrace.hxx
new file mode 100644
index 000000000000..e8acefcb2ed8
--- /dev/null
+++ b/canvas/inc/canvas/verbosetrace.hxx
@@ -0,0 +1,72 @@
+/*************************************************************************
+ *
+ *  $RCSfile: verbosetrace.hxx,v $
+ *
+ *  $Revision: 1.2 $
+ *
+ *  last change: $Author: thb $ $Date: 2004-03-18 10:38:26 $
+ *
+ *  The Contents of this file are made available subject to the terms of
+ *  either of the following licenses
+ *
+ *         - GNU Lesser General Public License Version 2.1
+ *         - Sun Industry Standards Source License Version 1.1
+ *
+ *  Sun Microsystems Inc., October, 2000
+ *
+ *  GNU Lesser General Public License Version 2.1
+ *  =============================================
+ *  Copyright 2000 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
+ *
+ *
+ *  Sun Industry Standards Source License Version 1.1
+ *  =================================================
+ *  The contents of this file are subject to the Sun Industry Standards
+ *  Source License Version 1.1 (the "License"); You may not use this file
+ *  except in compliance with the License. You may obtain a copy of the
+ *  License at http://www.openoffice.org/license.html.
+ *
+ *  Software provided under this License is provided on an "AS IS" basis,
+ *  WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
+ *  WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
+ *  MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
+ *  See the License for the specific provisions governing your rights and
+ *  obligations concerning the Software.
+ *
+ *  The Initial Developer of the Original Code is: Sun Microsystems, Inc.
+ *
+ *  Copyright: 2000 by Sun Microsystems, Inc.
+ *
+ *  All Rights Reserved.
+ *
+ *  Contributor(s): _______________________________________
+ *
+ *
+ ************************************************************************/
+
+#ifndef _CANVAS_VERBOSETRACE_HXX
+#define _CANVAS_VERBOSETRACE_HXX
+
+#ifdef VERBOSE
+/// Wrap OSL_TRACE with a verbosity switch
+#define VERBOSE_TRACE     OSL_TRACE
+#else
+#define VERBOSE_TRACE     1 ? ((void)0) : OSL_TRACE
+#endif
+
+#endif /* _CANVAS_VERBOSETRACE_HXX */