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
|
/* -*- 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 .
*/
#ifndef INCLUDED_SLIDESHOW_SOURCE_INC_ANIMATIONNODE_HXX
#define INCLUDED_SLIDESHOW_SOURCE_INC_ANIMATIONNODE_HXX
#include "disposable.hxx"
#include <com/sun/star/animations/XAnimationNode.hpp>
#include <memory>
namespace slideshow::internal
{
class AnimationNode;
typedef ::std::shared_ptr<AnimationNode> AnimationNodeSharedPtr;
/** This interface is used to mirror every XAnimateNode object
in the presentation core.
*/
class AnimationNode : public Disposable
{
public:
/** The current state of this AnimationNode
*/
enum NodeState
{
/// Invalid state, node is disposed or otherwise invalid
INVALID = 0,
/// Unresolved start time
UNRESOLVED = 1,
/// Resolved start time, node will start eventually
RESOLVED = 2,
/// Node is active
ACTIVE = 4,
/// Node is frozen (no longer active, but changes remain in place)
FROZEN = 8,
/// Node has completed an active lifecycle,
/// and any effect is removed from the document
ENDED = 16
};
/** Query the corresponding XAnimationNode.
*/
virtual css::uno::Reference<css::animations::XAnimationNode> getXAnimationNode() const = 0;
/** Init this node
If this node is not in state INVALID, init() sets up the
node state and schedules necessary events.
If this node has children, they have their init() called, too.
You will call this method whenever a slide is going to be
shown.
@return true, if init was successful; state has changed to UNRESOLVED
*/
virtual bool init() = 0;
/** Resolve node start time
Nodes can have unresolved start times, i.e. indefinite
start time for container nodes, or child nodes whose
parent has not yet started. Calling this method fixes
the node's start time. This does not mean that this
node immediately starts its animations, that is only
the case for begin=0.0. The node will change its state
to RESOLVED.
@return true, if a start event was successfully scheduled.
*/
virtual bool resolve() = 0;
/** Immediately start this node
This method starts the animation on this node, without
begin timeout. The node will change its state to ACTIVE.
*/
virtual void activate() = 0;
/** Immediately stop this node
This method stops the animation on this node. The node
will change its state to either ENDED or FROZEN,
depending on XAnimationNode attributes.
*/
virtual void deactivate() = 0;
/** End the animation on this node
This method force-ends animation on this node. Parents
may call this for their children, if their active
duration ends. An ended animation will no longer have
any effect on the shape attributes. The node will
change its state to ENDED.
*/
virtual void end() = 0;
/** Query node state
@return the current state of this animation node.
*/
virtual NodeState getState() const = 0;
/** Register a deactivating listener
This method registers another AnimationNode as an
deactivating listener, which gets notified via a
notifyDeactivating() call. The node calls all
registered listener, when it leaves the ACTIVE state.
@param rNotifee AnimationNode to notify
*/
virtual bool registerDeactivatingListener(const AnimationNodeSharedPtr& rNotifee) = 0;
/** Called to notify another AnimationNode's deactivation
@param rNotifier The instance who calls this method.
*/
virtual void notifyDeactivating(const AnimationNodeSharedPtr& rNotifier) = 0;
/** Called by the container to remove the animation effect
to make the painted shape correct if it restart because
of repeat or rewind ( fill mode is AnimationFill::REMOVE )
to start state.
*/
virtual void removeEffect() = 0;
/** Query node whether it has an animation pending.
@return true, if this node (or at least one of its children)
has an animation pending. Used to determine if the main
sequence is actually empty, or contains effects
*/
virtual bool hasPendingAnimation() const = 0;
};
} // namespace presentation::internal
#endif // INCLUDED_SLIDESHOW_SOURCE_INC_ANIMATIONNODE_HXX
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|