1 #ifndef DALI_SCENE3D_LOADERERERERER_RESOURCE_BUNDLE_H_
2 #define DALI_SCENE3D_LOADERERERERER_RESOURCE_BUNDLE_H_
4 * Copyright (c) 2022 Samsung Electronics Co., Ltd.
6 * Licensed under the Apache License, Version 2.0 (the "License");
7 * you may not use this file except in compliance with the License.
8 * You may obtain a copy of the License at
10 * http://www.apache.org/licenses/LICENSE-2.0
12 * Unless required by applicable law or agreed to in writing, software
13 * distributed under the License is distributed on an "AS IS" BASIS,
14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 * See the License for the specific language governing permissions and
16 * limitations under the License.
21 #include <dali-scene3d/public-api/loader/environment-definition.h>
22 #include <dali-scene3d/public-api/loader/material-definition.h>
23 #include <dali-scene3d/public-api/loader/mesh-definition.h>
24 #include <dali-scene3d/public-api/loader/shader-definition.h>
25 #include <dali-scene3d/public-api/loader/skeleton-definition.h>
26 #include <dali-scene3d/public-api/loader/buffer-definition.h>
31 #include <dali/public-api/common/vector-wrapper.h>
32 #include <dali/public-api/rendering/shader.h>
33 #include <dali/public-api/rendering/texture-set.h>
42 * @brief The types of resources that .dli may define.
44 struct DALI_SCENE3D_API ResourceType
54 ResourceType() = delete;
58 * @return The string value corresponding to the given resource @a type.
60 DALI_SCENE3D_API const char* GetResourceTypeName(ResourceType::Value type);
62 using ResourceRefCounts = std::vector<Vector<uint32_t>>;
65 * @brief Stores all resource definitions along with the DALi resources that
66 * could be created from them, directly indexible into with values from a dli
69 class DALI_SCENE3D_API ResourceBundle
79 ForceReload = NthBit(0), ///< Load resources [again] even if they were already loaded.
80 KeepUnused = NthBit(1) ///<s Don't reset handles to resources that had a 0 reference count.
84 using PathProvider = std::function<std::string(ResourceType::Value)>;
86 ResourceBundle() = default;
88 ResourceBundle(const ResourceBundle&) = delete;
89 ResourceBundle& operator=(const ResourceBundle&) = delete;
91 ResourceBundle(ResourceBundle&&) = default;
92 ResourceBundle& operator=(ResourceBundle&&) = default;
95 * @return A ResourceRefCounts object with the correct number of entries for
96 * all resource types (based on the various resource definition vectors),
97 * with all reference counts set to 0.
99 ResourceRefCounts CreateRefCounter() const;
102 * @brief Based on a ResourceRefCounts, and more specifically the reference
103 * count of materials therein, it will calculate the reference count of
106 void CountEnvironmentReferences(ResourceRefCounts& refCounts) const;
109 * @brief Performs the loading of all resources based on their respective
110 * reference count in @a refCounts. Resources that had a non-zero ref count will be
111 * loaded unless we already have a handle to them (OR the ForceReload option was specified).
112 * Any handles we have to resources that come in with a zero ref count will be reset,
113 * UNLESS the KeepUnused option was specified.
114 * @param[in] refCounts Reference Count that denote how many the resource is used.
115 * @param[in] pathProvider path provider for resource data.
116 * @param[in] options Option to load resource
117 * @note This method creates DALi objects like Dali::Texture, Dali::Geometry, etc.
119 void LoadResources(const ResourceRefCounts& refCounts,
120 PathProvider pathProvider,
121 Options::Type options = Options::None);
124 * @brief Loads of all resources based on their respective
125 * reference count in @a refCounts. Resources that had a non-zero ref count will be
126 * loaded unless we already have a handle to them (OR the ForceReload option was specified).
127 * Any handles we have to resources that come in with a zero ref count will be reset,
128 * UNLESS the KeepUnused option was specified.
129 * @note This method don't create any of DALi objects.
130 * @param[in] refCounts Reference Count that denote how many the resource is used.
131 * @param[in] pathProvider path provider for resource data.
132 * @param[in] options Option to load resource
133 * @note This method only loads raw data from resource file, and
134 * doesn't create any of DALi objects. GenerateResources() method is required to be called
135 * after this method to create DALi objects.
137 void LoadRawResources(const ResourceRefCounts& refCounts,
138 PathProvider pathProvider,
139 Options::Type options = Options::None);
142 * @brief Generates DALi objects from already loaded Raw Resources.
143 * @param[in] refCounts Reference Count that denote how many the resource is used.
144 * @param[in] options Option to load resource
145 * @note This method generates DALi objects from raw data that is already
146 * loaded by LoadRawResources method. Therefore, LoadRawResources should be called first
147 * before this method is called.
149 void GenerateResources(const ResourceRefCounts& refCounts,
150 Options::Type options = Options::None);
153 EnvironmentDefinition::Vector mEnvironmentMaps;
154 ShaderDefinition::Vector mShaders;
155 MeshDefinition::Vector mMeshes;
156 MaterialDefinition::Vector mMaterials;
158 SkeletonDefinition::Vector mSkeletons;
159 BufferDefinition::Vector mBuffers;
162 } // namespace Loader
163 } // namespace Scene3D
166 #endif //DALI_SCENE3D_LOADERERERERER_RESOURCE_BUNDLE_H_