1 #ifndef DALI_INTERNAL_UPDATE_PROXY_IMPL_H
2 #define DALI_INTERNAL_UPDATE_PROXY_IMPL_H
5 * Copyright (c) 2022 Samsung Electronics Co., Ltd.
7 * Licensed under the Apache License, Version 2.0 (the "License");
8 * you may not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
11 * http://www.apache.org/licenses/LICENSE-2.0
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS,
15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
26 #include <dali/internal/common/buffer-index.h>
27 #include <dali/internal/update/manager/transform-manager.h>
28 #include <dali/internal/update/nodes/node.h>
29 #include <dali/public-api/common/vector-wrapper.h>
30 #include <dali/public-api/math/matrix.h>
31 #include <dali/public-api/math/vector3.h>
43 * @brief The implementation of Dali::UpdateProxy.
45 * Ref-counting is not required for this object.
47 * @see Dali::UpdateProxy
54 * @param[in] updateManager Ref to the UpdateManager in order to add property resetters
55 * @param[in] transformManager Ref to the TransformManager in order to set/get transform properties of nodes
56 * @param[in] rootNode The root node for this proxy
58 UpdateProxy(SceneGraph::UpdateManager& updateManager, SceneGraph::TransformManager& transformManager, SceneGraph::Node& rootNode);
65 // Movable but not copyable
67 UpdateProxy(const UpdateProxy&) = delete; ///< Deleted copy constructor.
68 UpdateProxy(UpdateProxy&&) = default; ///< Default move constructor.
69 UpdateProxy& operator=(const UpdateProxy&) = delete; ///< Deleted copy assignment operator.
70 UpdateProxy& operator=(UpdateProxy&&) = delete; ///< Deleted move assignment operator.
73 * @copydoc Dali::UpdateProxy::GetPosition()
75 bool GetPosition(uint32_t id, Vector3& position) const;
78 * @copydoc Dali::UpdateProxy::SetPosition()
80 bool SetPosition(uint32_t id, const Vector3& position);
83 * @copydoc Dali::UpdateProxy::BakePosition()
85 bool BakePosition(uint32_t id, const Vector3& position);
88 * @copydoc Dali::UpdateProxy::GetSize()
90 bool GetSize(uint32_t id, Vector3& size) const;
93 * @copydoc Dali::UpdateProxy::SetSize()
95 bool SetSize(uint32_t id, const Vector3& size);
98 * @copydoc Dali::UpdateProxy::BakeSize()
100 bool BakeSize(uint32_t id, const Vector3& size);
103 * @copydoc Dali::UpdateProxy::GetPositionAndSize()
105 bool GetPositionAndSize(uint32_t id, Vector3& position, Vector3& size) const;
108 * @copydoc Dali::UpdateProxy::GetWorldPositionScaleAndSize()
110 bool GetWorldPositionScaleAndSize(uint32_t id, Vector3& position, Vector3& scale, Vector3& size) const;
113 * @copydoc Dali::UpdateProxy::GetScale()
115 bool GetScale(uint32_t id, Vector3& scale) const;
118 * @copydoc Dali::UpdateProxy::SetScale()
120 bool SetScale(uint32_t id, const Vector3& scale);
123 * @copydoc Dali::UpdateProxy::BakeScale()
125 bool BakeScale(uint32_t id, const Vector3& scale);
128 * @copydoc Dali::UpdateProxy::GetColor()
130 bool GetColor(uint32_t id, Vector4& color) const;
133 * @copydoc Dali::UpdateProxy::SetColor()
135 bool SetColor(uint32_t id, const Vector4& color);
138 * @copydoc Dali::UpdateProxy::BakeColor()
140 bool BakeColor(uint32_t id, const Vector4& color);
143 * @brief Retrieves the root-node used by this class
144 * @return The root node used by this class.
146 SceneGraph::Node& GetRootNode() const
152 * @brief Sets the buffer index to use when processing the next callback.
153 * @param[in] bufferIndex The current buffer index
155 void SetCurrentBufferIndex(BufferIndex bufferIndex)
157 mCurrentBufferIndex = bufferIndex;
161 * @brief Informs the update-proxy that the node hierarchy has changed.
163 void NodeHierarchyChanged();
166 * @brief Adds node resetter for each dirty node whose animatable properties have been changed.
168 void AddNodeResetters();
172 * @brief Retrieves the node with the specified ID.
173 * @param[in] id The ID of the node required
174 * @return A pointer to the required node if found.
175 * @note This caches the last accessed node.
177 SceneGraph::Node* GetNodeWithId(uint32_t id) const;
180 * @brief Adds a property-resetter for non-transform properties so that they can be reset to their base value every frame.
181 * @param[in] node The node the property belongs to
182 * @param[in] propertyBase The property itself
184 void AddResetter(SceneGraph::Node& node, SceneGraph::PropertyBase& propertyBase);
188 * Structure to store the ID & Node pair
192 uint32_t id; ///< The ID of the node
193 SceneGraph::Node* node; ///< The node itself
196 class PropertyModifier;
197 using PropertyModifierPtr = std::unique_ptr<PropertyModifier>;
199 mutable std::vector<IdNodePair> mNodeContainer; ///< Used to store cached pointers to already searched for Nodes.
200 mutable IdNodePair mLastCachedIdNodePair; ///< Used to cache the last retrieved id-node pair.
201 mutable std::vector<uint32_t> mDirtyNodes; ///< Used to store the ID of the dirty nodes with non-transform property modifications.
202 BufferIndex mCurrentBufferIndex;
204 SceneGraph::UpdateManager& mUpdateManager; ///< Reference to the Update Manager.
205 SceneGraph::TransformManager& mTransformManager; ///< Reference to the Transform Manager.
206 SceneGraph::Node& mRootNode; ///< The root node of this update proxy.
208 PropertyModifierPtr mPropertyModifier; ///< To ensure non-transform property modifications reset to base values.
211 } // namespace Internal
215 #endif // DALI_INTERNAL_UPDATE_PROXY_IMPL_H