3c7ccb75f4
2006/11/01 15:28:00 thb 1.5.10.5: #142663# Registering slide as a view change listener; added viewChange methods to various interfaces (Shape, LayerManager, Layer, a few view shapes); made EventMultiplexer prune list of weakly held handlers from deceased ones; refactored applet and media shape update() method into render() and resize() 2006/03/24 18:23:36 thb 1.5.10.4: #i37778# Moved whole slideshow engine from namespace presentation (which conflicts with one of the UNO subnamespaces) to slideshow 2006/03/23 17:22:44 thb 1.5.10.3: #i49357# Changed manual noncopyable boiler plate to boost::noncopyable 2006/03/15 15:22:23 thb 1.5.10.2: #i49357# Removed external include guards from all non-export headers (and from the cxx files, anyway) 2006/03/06 22:14:35 thb 1.5.10.1: #i53194# #i55294# #i59324# Overhauled IntrinsicAnimationActivity; fixes GIF animation import; corrected rehearse timings sprite size; several cosmetic changes (removed external header guards); prepared scene for sprite prio
308 lines
12 KiB
C++
308 lines
12 KiB
C++
/*************************************************************************
|
|
*
|
|
* OpenOffice.org - a multi-platform office productivity suite
|
|
*
|
|
* $RCSfile: shape.hxx,v $
|
|
*
|
|
* $Revision: 1.6 $
|
|
*
|
|
* last change: $Author: kz $ $Date: 2006-12-13 16:01:16 $
|
|
*
|
|
* 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 _SLIDESHOW_SHAPE_HXX
|
|
#define _SLIDESHOW_SHAPE_HXX
|
|
|
|
#include <com/sun/star/uno/Reference.hxx>
|
|
#include <com/sun/star/drawing/XShape.hpp>
|
|
#include <com/sun/star/drawing/XDrawPage.hpp>
|
|
|
|
#include <basegfx/range/b2drectangle.hxx>
|
|
|
|
#include <boost/shared_ptr.hpp>
|
|
#include <boost/utility.hpp>
|
|
|
|
#include <viewlayer.hxx>
|
|
#include <set>
|
|
|
|
#include <vector>
|
|
|
|
namespace slideshow
|
|
{
|
|
namespace internal
|
|
{
|
|
// forward declaration necessary, because methods use ShapeSharedPtr
|
|
class Shape;
|
|
|
|
typedef ::boost::shared_ptr< Shape > ShapeSharedPtr;
|
|
|
|
/** Represents a slide's shape object.
|
|
|
|
This interface represents the view-independent aspects of a
|
|
slide's shape, providing bound rect, underlying XShape and
|
|
basic paint methods.
|
|
*/
|
|
class Shape : private boost::noncopyable
|
|
{
|
|
public:
|
|
virtual ~Shape() {}
|
|
|
|
/** Get the associated XShape of this shape.
|
|
|
|
@return the associated XShape. If this method returns
|
|
an empty reference, this object might be one of the
|
|
special-purpose shapes of a slide, which have no
|
|
direct corresponding XShape (the background comes to
|
|
mind here).
|
|
*/
|
|
virtual ::com::sun::star::uno::Reference<
|
|
::com::sun::star::drawing::XShape > getXShape() const = 0;
|
|
|
|
|
|
// View layer methods
|
|
//------------------------------------------------------------------
|
|
|
|
/** Add a new view layer.
|
|
|
|
This method adds a new view layer, this shape shall
|
|
show itself on.
|
|
|
|
@param rNewLayer
|
|
New layer to show on
|
|
|
|
@param bRedrawLayer
|
|
Redraw shape on given layer
|
|
*/
|
|
virtual void addViewLayer( const ViewLayerSharedPtr& rNewLayer,
|
|
bool bRedrawLayer ) = 0;
|
|
|
|
/** Withdraw the shape from a view layer
|
|
|
|
This method removes the shape from the given view
|
|
layer.
|
|
|
|
@return true, if the shape was successfully removed
|
|
*/
|
|
virtual bool removeViewLayer( const ViewLayerSharedPtr& rNewLayer ) = 0;
|
|
|
|
/** Withdraw all view layers at once
|
|
|
|
This method will be faster than repeated
|
|
removeViewLayer() calls.
|
|
*/
|
|
virtual bool clearAllViewLayers() = 0;
|
|
|
|
// TODO(Q3): This is a wart. Use broadcaster, where
|
|
// everyone interested can register at.
|
|
|
|
/** Notify that view layer has changed
|
|
|
|
@param rNewLayer
|
|
View layer that changed (size, transformation etc.)
|
|
*/
|
|
virtual void viewLayerChanged( const ViewLayerSharedPtr& rNewLayer ) = 0;
|
|
|
|
// render methods
|
|
//------------------------------------------------------------------
|
|
|
|
/** Update the shape
|
|
|
|
This method updates the Shape on all registered view
|
|
layers, but only if shape content has actually
|
|
changed.
|
|
|
|
@return whether the update finished successfully.
|
|
*/
|
|
virtual bool update() const = 0;
|
|
|
|
/** Render the shape.
|
|
|
|
This method renders the shape on all registered view
|
|
layers, regardless of whether shape content has
|
|
changed or not.
|
|
|
|
@return whether the rendering finished successfully.
|
|
*/
|
|
virtual bool render() const = 0;
|
|
|
|
/** Query whether an update is necessary.
|
|
|
|
This method returns true, if shape content changed
|
|
since the last rendering (i.e. the shape needs an
|
|
update to reflect that changed content on the views).
|
|
*/
|
|
virtual bool isUpdateNecessary() const = 0;
|
|
|
|
|
|
// Shape attributes
|
|
//------------------------------------------------------------------
|
|
|
|
/** Get the current shape position and size.
|
|
|
|
This method yields the currently effective shape
|
|
bounds (which might change over time, for animated
|
|
shapes). Please note that possibly shape rotations
|
|
from its original document state must not be taken
|
|
into account here: if you need the screen bounding
|
|
box, use getUpdateArea() instead. Note further that
|
|
shape rotations, which are already contained in the
|
|
shape as displayed in the original document
|
|
<em>are</em> included herein (we currently take the
|
|
shape as-is from the document, assuming a rotation
|
|
angle of 0).
|
|
*/
|
|
virtual ::basegfx::B2DRectangle getPosSize() const = 0;
|
|
|
|
/** Get the DOM position and size of the shape.
|
|
|
|
This method yields the underlying DOM shape bounds,
|
|
i.e. the original shape bounds from the document
|
|
model. This value is <em>always</em> unaffected by any
|
|
animation activity. Note that shape rotations, which
|
|
are already contained in the shape as displayed in the
|
|
original document are already included herein (we
|
|
currently take the shape as-is from the document,
|
|
assuming a rotation angle of 0).
|
|
*/
|
|
virtual ::basegfx::B2DRectangle getDOMBounds() const = 0;
|
|
|
|
/** Get the current shape update area.
|
|
|
|
This method yields the currently effective update area
|
|
for the shape, i.e. the area that needs to be updated,
|
|
should the shape be painted. Normally, this will be
|
|
the (possibly rotated and sheared) area returned by
|
|
getPosSize().
|
|
*/
|
|
virtual ::basegfx::B2DRectangle getUpdateArea() const = 0;
|
|
|
|
/** Query whether the shape is visible at all.
|
|
|
|
@return true, if this shape is visible, false
|
|
otherwise.
|
|
*/
|
|
virtual bool isVisible() const = 0;
|
|
|
|
/** Get the shape priority.
|
|
|
|
The shape priority defines the relative order of the
|
|
shapes on the slide.
|
|
|
|
@return the priority. Will be in the [0,+infty) range.
|
|
*/
|
|
virtual double getPriority() const = 0;
|
|
|
|
/** Query whether the Shape is currently detached from the
|
|
background.
|
|
|
|
This method checks whether the Shape is currently
|
|
detached from the slide background, i.e. whether shape
|
|
updates affect the underlying slide background or
|
|
not. A shape that returnes true here must not alter
|
|
slide content in any way when called render() or
|
|
update() (this is normally achieved by making this
|
|
shape a sprite).
|
|
*/
|
|
virtual bool isBackgroundDetached() const = 0;
|
|
|
|
// TODO(Q1): Maybe the hasIntrinsicAnimation() method is
|
|
// superfluous. Depending on the RTTI implementation, that
|
|
// might do exactly the same.
|
|
|
|
/** Query whether shape has intrinsic animation.
|
|
|
|
This method must return true, if the shape has an
|
|
intrinsic animation (e.g. drawing layer animation, or
|
|
animated GIF), which needs external update triggers.
|
|
|
|
@return true, if this shape is intrinsically animated.
|
|
|
|
@see IntrinsicAnimation interface
|
|
*/
|
|
virtual bool hasIntrinsicAnimation() const = 0;
|
|
|
|
typedef ::std::pair< ::basegfx::B2DRectangle,
|
|
::rtl::OUString > HyperLinkRegion;
|
|
typedef ::std::vector<HyperLinkRegion> HyperLinkRegions;
|
|
|
|
/** Checks whether this shape has hyperlinks to be clicked.
|
|
*/
|
|
virtual bool hasHyperlinks() const = 0;
|
|
|
|
/** @return the position and size of all hyperlinks relative to
|
|
the upper left corner of the shape.
|
|
*/
|
|
virtual HyperLinkRegions getHyperlinkRegions() const = 0;
|
|
|
|
// Misc
|
|
//------------------------------------------------------------------
|
|
|
|
/** Functor struct, for shape ordering
|
|
|
|
This defines a strict weak ordering of shapes, primary
|
|
sort key is the shape priority, and secondy sort key
|
|
the object ptr value. Most typical use is for
|
|
associative containers holding shapes (and which also
|
|
have to maintain something like a paint order).
|
|
*/
|
|
struct lessThanShape
|
|
{
|
|
// make functor adaptable (to boost::bind)
|
|
typedef bool result_type;
|
|
|
|
// since the ZOrder property on the XShape has somewhat
|
|
// peculiar attributes (it's basically the index of the shapes
|
|
// in the drawing layer's SdrObjList - which means, it starts
|
|
// from 0 for children of group objects), we cannot use it to determine
|
|
// drawing order. Thus, we rely on importer-provided order values here,
|
|
// which is basically a running counter during shape import (i.e. denotes
|
|
// the order of shape import). This is the correct order, at least for the
|
|
// current drawing core.
|
|
//
|
|
// If, someday, the above proposition is no longer true, one directly use
|
|
// the shape's ZOrder property
|
|
//
|
|
inline bool operator()(const ShapeSharedPtr& rLHS, const ShapeSharedPtr& rRHS) const
|
|
{
|
|
const double nPrioL( rLHS->getPriority() );
|
|
const double nPrioR( rRHS->getPriority() );
|
|
|
|
// if prios are equal, tie-break on ptr value
|
|
return nPrioL == nPrioR ? rLHS.get() < rRHS.get() : nPrioL < nPrioR;
|
|
}
|
|
};
|
|
};
|
|
|
|
typedef ::boost::shared_ptr< Shape > ShapeSharedPtr;
|
|
|
|
/** A set which contains all shapes in an ordered fashion.
|
|
*/
|
|
typedef ::std::set< ShapeSharedPtr, Shape::lessThanShape > ShapeSet;
|
|
}
|
|
}
|
|
|
|
#endif /* _SLIDESHOW_SHAPE_HXX */
|