1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
|
/*************************************************************************
*
* OpenOffice.org - a multi-platform office productivity suite
*
* $RCSfile: viewinformation2d.hxx,v $
*
* $Revision: 1.7 $
*
* last change: $Author: aw $ $Date: 2008-06-24 15:30: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 INCLUDED_DRAWINGLAYER_GEOMETRY_VIEWINFORMATION2D_HXX
#define INCLUDED_DRAWINGLAYER_GEOMETRY_VIEWINFORMATION2D_HXX
// the solaris compiler defines 'sun' as '1'. To avoid that (and to allow
// pre-declarations of com/sun/star namespace), include sal/config.h here
// where sun is redefined as 'sun' (so i guess the problem is known).
#include <sal/config.h>
#include <com/sun/star/uno/Sequence.h>
#include <com/sun/star/beans/PropertyValue.hpp>
#include <com/sun/star/drawing/XDrawPage.hpp>
//////////////////////////////////////////////////////////////////////////////
// predefines
namespace drawinglayer { namespace geometry {
class ImpViewInformation2D;
}}
namespace basegfx {
class B2DHomMatrix;
class B2DRange;
}
//////////////////////////////////////////////////////////////////////////////
namespace drawinglayer
{
namespace geometry
{
/** ViewInformation2D class
This class holds all view-relevant information for a 2d geometry. It works
together with UNO API definitions and supports holding a sequence of PropertyValues.
The most used data is for convenience offered directly using basegfx tooling classes.
It is an implementation to support the sequence of PropertyValues used in a
::com::sun::star::graphic::XPrimitive2D for C++ implementations working with those
*/
class ViewInformation2D
{
private:
/// pointer to private implementation class
ImpViewInformation2D* mpViewInformation2D;
public:
/** Constructor: Create a ViewInformation2D
@param rObjectTransformation
The Transformation from Object to World coordinates (normally logic coordinates).
@param rViewTransformation
The Transformation from World to View coordinates (normally logic coordinates
to discrete units, e.g. pixels).
@param rViewport
The visible part of the view in World coordinates. If empty (getViewport().isEmpty())
everything is visible. The data is in World coordinates.
@param rxDrawPage
The currently displaqyed page. This information is needed e.g. due to existing PageNumber
fields which need to be interpreted.
@param fViewTime
The time the view is defined for. Default is 0.0. This parameter is used e.g. for
animated objects
@param rExtendedParameters
A sequence of property values which allows holding various other parameters besides
the obvious and needed ones above. For this constructor none of the other parameters
should be added as data. The constructor will parse the given parameters and if
data for the other parameters is given, the value in rExtendedParameters will
be preferred and overwrite the given parameter
*/
ViewInformation2D(
const basegfx::B2DHomMatrix& rObjectTransformation,
const basegfx::B2DHomMatrix& rViewTransformation,
const basegfx::B2DRange& rViewport,
const ::com::sun::star::uno::Reference< ::com::sun::star::drawing::XDrawPage >& rxDrawPage,
double fViewTime,
const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue >& rExtendedParameters);
/** Constructor: Create a ViewInformation2D
@param rViewParameters
A sequence of property values which allows holding any combination of local and various
other parameters. This constructor is feeded completely with a sequence of PropertyValues
which will be parsed to be able to offer the most used ones in a convenient way.
*/
ViewInformation2D(const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue >& rViewParameters);
/// default (empty) constructor
ViewInformation2D();
/// copy constructor
ViewInformation2D(const ViewInformation2D& rCandidate);
/// destructor
~ViewInformation2D();
// checks if the incarnation is default constructed
bool isDefault() const;
/// assignment operator
ViewInformation2D& operator=(const ViewInformation2D& rCandidate);
/// compare operators
bool operator==(const ViewInformation2D& rCandidate) const;
bool operator!=(const ViewInformation2D& rCandidate) const { return !operator==(rCandidate); }
/// data access
const basegfx::B2DHomMatrix& getObjectTransformation() const;
const basegfx::B2DHomMatrix& getViewTransformation() const;
const basegfx::B2DRange& getViewport() const;
double getViewTime() const;
const ::com::sun::star::uno::Reference< ::com::sun::star::drawing::XDrawPage >& getVisualizedPage() const;
/// On-demand prepared Object to View transformation and it's inerse for convenience
const basegfx::B2DHomMatrix& getObjectToViewTransformation() const;
const basegfx::B2DHomMatrix& getInverseObjectToViewTransformation() const;
/// On-demand prepared Viewport in discrete units for convenience
const basegfx::B2DRange& getDiscreteViewport() const;
/** support reduced DisplayQuality, PropertyName is 'ReducedDisplayQuality'. This
is used e.g. to allow to lower display quality for OverlayPrimitives and
may lead to simpler decompositions in the local create2DDecomposition
implementations of the primitives
*/
bool getReducedDisplayQuality() const;
/** Get the uno::Sequence< beans::PropertyValue > which contains all ViewInformation
Use this call if You need to extract all contained ViewInformation. The ones
directly supported for convenience will be added to the ones only available
as PropertyValues. This set completely describes this ViewInformation2D and
can be used for complete information transport over UNO API.
*/
const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue >& getViewInformationSequence() const;
/** Get the uno::Sequence< beans::PropertyValue > which contains only ViewInformation
not offered directly
Use this call if You only need ViewInformation which is not offered conveniently,
but only exists as PropertyValue. This is e.g. used to create partially updated
incarnations of ViewInformation2D without losing the only with PropertyValues
defined data. It does not contain a complete description.
*/
const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue >& getExtendedInformationSequence() const;
};
} // end of namespace geometry
} // end of namespace drawinglayer
//////////////////////////////////////////////////////////////////////////////
#endif //INCLUDED_DRAWINGLAYER_GEOMETRY_VIEWINFORMATION2D_HXX
// eof
|
