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
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
|
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed
* with this work for additional information regarding copyright
* ownership. The ASF licenses this file to you under the Apache
* License, Version 2.0 (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.apache.org/licenses/LICENSE-2.0 .
*/
#pragma once
#include <memory>
#include "animatableshape.hxx"
#include "shapeattributelayer.hxx"
#include "doctreenodesupplier.hxx"
namespace slideshow::internal
{
// forward declaration necessary, because methods use AttributableShapeSharedPtr
class AttributableShape;
typedef ::std::shared_ptr< AttributableShape > AttributableShapeSharedPtr;
/** Represents an animatable shape, that can have its
attributes changed.
Over an animatable shape, this interface adds attribute
modification methods. Furthermore, the shape can be
queried for sub items, which in turn can be separated out
into own AttributableShapes.
*/
class AttributableShape : public AnimatableShape
{
public:
// Attribute layer methods
/** Create a new shape attribute layer.
This method creates a new layer for shape attributes,
which lies atop of all previous attribute layers. That
is most typically used when a new SMIL animation
starts (which according to the spec always lies atop
of all previous animations). Thus, subsequent calls to
this method generate a sandwich of attribute layers,
which in total define the shape's attributes.
Please note that the attribute layers do <em>not</em>
contain the underlying XShape's attributes as
default. Instead, attributes not explicitly set by
animations remain in invalid state, allowing the
shape's paint method to determine whether they have to
override the underlying graphical shape
representation. XShape attributes must be passed
explicitly to animations which need them (e.g. 'by'
animations).
@return the new layer
*/
virtual ShapeAttributeLayerSharedPtr createAttributeLayer() = 0;
/** Revoke a previously generated attribute layer.
This method revokes a previously generated attribute
layer, and removes the effect of that layer from this
shape. The layer need not be the current toplevel
layer, it can also be revoked from in between.
@param rLayer
Layer to revoke. Must have been generated by
createAttributeLayer() at the same Shape.
@return true, if layer was successfully removed, false
otherwise (e.g. if the given layer was not generated
for this shape).
*/
virtual bool revokeAttributeLayer( const ShapeAttributeLayerSharedPtr& rLayer ) = 0;
/** Get the topmost shape attribute layer (if any).
This method returns the topmost layer for shape
attributes, i.e. the one which ultimately determines
the shape's look.
Please note that the attribute layers do <em>not</em>
contain the underlying XShape's attributes as
default. Instead, attributes not explicitly set by
animations remain in invalid state, allowing the
shape's paint method to determine whether they have to
override the underlying graphical shape
representation. XShape attributes must be passed
explicitly to animations which need them (e.g. 'by'
animations).
@return the topmost layer
*/
virtual ShapeAttributeLayerSharedPtr getTopmostAttributeLayer() const = 0;
/** Change default shape visibility
This method hides or unhides a shape. Note that every
attribute layer generated for this shape is able to
override the setting given here, until it is revoked.
@param bVisible
When true, shape will be visible, when false,
invisible (modulo attribute layer overrides).
*/
virtual void setVisibility( bool bVisible ) = 0;
// Sub-item handling
/** Retrieve interface for DocTreeNode creation.
This method provides the caller with a reference to
the DocTreeNodeSupplier interface, which can be used
to request specific tree nodes for this shape.
*/
virtual const DocTreeNodeSupplier& getTreeNodeSupplier() const = 0;
virtual DocTreeNodeSupplier& getTreeNodeSupplier() = 0;
/** Query the subset this shape displays.
This method returns a tree node denoting the subset
displayed by this shape. If this shape is not a subset
shape, an empty tree node should be returned. If this
shape is a subset, and itself has subsetted children,
this method might return more than the shape is
actually displaying (because a single DocTreeNode is
not able to model holes in the range).
*/
virtual DocTreeNode getSubsetNode() const = 0;
/** Query a subset Shape, if already existent at this
object
This method returns a clone of this Shape, which
renders only the selected subset of itself, but only
if such a subset has been explicitly created before.
@param rTreeNode
A DocTreeNode instance queried from this Shape, which
specifies the subset of the Shape to render.
@return a NULL Shape pointer, if no subset exists for
the given DocTreeNode.
*/
virtual AttributableShapeSharedPtr getSubset( const DocTreeNode& rTreeNode ) const = 0;
/** Create a subset Shape
This method creates a clone of this Shape, which
renders only the selected subset of itself. Multiple
createSubset() calls for the same DocTreeNode will all
share the same subset shape.
The original shape (i.e. the one this method is called
on) will cease to display the selected subset
part. That is, together the shapes will display the
original content, but the content of all subset shapes
and their original shape will always be mutually
disjunct.
After deregistering the subset shape a matching number
of times via revokeSubset(), the original shape will
resume displaying the subsetted part.
@attention To maintain view integrity, this method
should only be called from the LayerManager
@param o_rSubset
The requested Shape
@param rTreeNode
A DocTreeNode instance queried from this Shape, which
specifies the subset of the Shape to render
@return true, if the shape was newly created, and
false, if an already existing subset is returned.
*/
virtual bool createSubset( AttributableShapeSharedPtr& o_rSubset,
const DocTreeNode& rTreeNode ) = 0;
/** Revoke a previously generated shape subset.
After revoking a subset shape, the corresponding
subset part will become visible again on the original
shape.
@attention To maintain view integrity, this method
should only be called from the LayerManager
@param rShape
The subset to revoke
@return true, if the last client called
revokeSubset().
*/
virtual bool revokeSubset( const AttributableShapeSharedPtr& rShape ) = 0;
};
}
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|
