1 #ifndef DALI_INTERNAL_SCENE_GRAPH_UNIFORM_MAP_H
2 #define DALI_INTERNAL_SCENE_GRAPH_UNIFORM_MAP_H
5 * Copyright (c) 2018 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.
22 #include <cstdint> // uint32_t
25 #include <dali/devel-api/common/hash.h>
26 #include <dali/devel-api/common/owner-container.h>
27 #include <dali/internal/common/const-string.h>
33 class PropertyInputImpl;
39 * The uniform map is used to map a uniform name to a property value.
41 class UniformPropertyMapping
47 UniformPropertyMapping(ConstString theUniformName, const PropertyInputImpl* thePropertyPtr)
48 : propertyPtr(thePropertyPtr),
49 uniformName(theUniformName)
53 UniformPropertyMapping() = default;
55 const PropertyInputImpl* propertyPtr{nullptr};
56 ConstString uniformName;
60 * The UniformMap class is used to map uniform names to property values. It is available
61 * in all of the classes responsible for rendering:
62 * Actor, Renderer, Geometry, TextureSet, Shader.
64 * It can be observed for changes to the mapping table.
69 using SizeType = uint32_t;
76 * Inform observer that uniform mappings have been changed
79 virtual void UniformMappingsChanged(const UniformMap& mappings) = 0;
84 * Virtual destructor, no deletion through this interface
86 virtual ~Observer() = default;
90 * Add an observer that watches for changes in the mappings
92 void AddObserver( Observer& observer );
97 void RemoveObserver( Observer& observer );
100 * Add a map to the mappings table.
102 void Add(UniformPropertyMapping map);
105 * Remove a map from the mappings table
107 void Remove( ConstString uniformName );
110 * Find a property given the uniform name.
111 * @return The address of the property if it's in the map, or NULL otherwise.
113 const PropertyInputImpl* Find( ConstString uniformName );
116 * Get the count of uniforms in the map
117 * @return The number of uniform mappings
119 SizeType Count() const;
122 * @pre index must be in the range 0 :: Count()-1
123 * @param[in] index The index of the element to fetch
124 * @return reference to the element in the map
126 const UniformPropertyMapping& operator[]( SizeType index ) const;
130 * Helper to call the observers when the mappings have changed
132 void MappingChanged();
135 using UniformMapContainer = Dali::Vector<UniformPropertyMapping>;
136 using UniformMapIter = UniformMapContainer::Iterator;
137 using Observers = Dali::Vector<Observer*>;
138 using ObserversIter = Observers::Iterator;
140 UniformMapContainer mUniformMaps; // Owner container of uniform maps
142 Observers mObservers;
146 } // namespace SceneGraph
147 } // namespace Internal
150 #endif // DALI_INTERNAL_SCENE_GRAPH_UNIFORM_MAP_H