1 #ifndef DALI_SCENE3D_LOADERERERER_RESOURCE_BUNDLE_H_
2 #define DALI_SCENE3D_LOADERERERER_RESOURCE_BUNDLE_H_
4 * Copyright (c) 2023 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/public-api/common/vector-wrapper.h>
22 #include <dali/public-api/rendering/shader.h>
23 #include <dali/public-api/rendering/texture-set.h>
28 #include <dali-scene3d/public-api/loader/buffer-definition.h>
29 #include <dali-scene3d/public-api/loader/environment-definition.h>
30 #include <dali-scene3d/public-api/loader/material-definition.h>
31 #include <dali-scene3d/public-api/loader/mesh-definition.h>
32 #include <dali-scene3d/public-api/loader/shader-definition.h>
33 #include <dali-scene3d/public-api/loader/skeleton-definition.h>
35 namespace Dali::Scene3D::Loader
38 * @brief The types of resources that .dli may define.
40 struct DALI_SCENE3D_API ResourceType
50 ResourceType() = delete;
54 * @return The string value corresponding to the given resource @a type.
56 DALI_SCENE3D_API const char* GetResourceTypeName(ResourceType::Value type);
58 using ResourceRefCounts = std::vector<Vector<uint32_t>>;
61 * @brief Stores all resource definitions along with the DALi resources that
62 * could be created from them, directly indexible into with values from a dli
65 class DALI_SCENE3D_API ResourceBundle
75 ForceReload = NthBit(0), ///< Load resources [again] even if they were already loaded.
76 KeepUnused = NthBit(1) ///<s Don't reset handles to resources that had a 0 reference count.
80 using PathProvider = std::function<std::string(ResourceType::Value)>;
84 ResourceBundle(const ResourceBundle&) = delete;
85 ResourceBundle& operator=(const ResourceBundle&) = delete;
87 ResourceBundle(ResourceBundle&&) = default;
88 ResourceBundle& operator=(ResourceBundle&&) = default;
91 * @return A ResourceRefCounts object with the correct number of entries for
92 * all resource types (based on the various resource definition vectors),
93 * with all reference counts set to 0.
95 ResourceRefCounts CreateRefCounter() const;
98 * @brief Based on a ResourceRefCounts, and more specifically the reference
99 * count of materials therein, it will calculate the reference count of
102 void CountEnvironmentReferences();
105 * @brief Performs the loading of all resources based on their respective
106 * reference count in @a refCounts. Resources that had a non-zero ref count will be
107 * loaded unless we already have a handle to them (OR the ForceReload option was specified).
108 * Any handles we have to resources that come in with a zero ref count will be reset,
109 * UNLESS the KeepUnused option was specified.
110 * @param[in] pathProvider path provider for resource data.
111 * @param[in] options Option to load resource
112 * @note This method creates DALi objects like Dali::Texture, Dali::Geometry, etc.
114 void LoadResources(PathProvider pathProvider,
115 Options::Type options = Options::None);
118 * @brief Loads of all resources based on their respective
119 * reference count in @a refCounts. Resources that had a non-zero ref count will be
120 * loaded unless we already have a handle to them (OR the ForceReload option was specified).
121 * Any handles we have to resources that come in with a zero ref count will be reset,
122 * UNLESS the KeepUnused option was specified.
123 * @note This method don't create any of DALi objects.
124 * @param[in] pathProvider path provider for resource data.
125 * @param[in] options Option to load resource
126 * @note This method only loads raw data from resource file, and
127 * doesn't create any of DALi objects. GenerateResources() method is required to be called
128 * after this method to create DALi objects.
130 void LoadRawResources(PathProvider pathProvider,
131 Options::Type options = Options::None);
134 * @brief Generates DALi objects from already loaded Raw Resources.
135 * @param[in] options Option to load resource
136 * @note This method generates DALi objects from raw data that is already
137 * loaded by LoadRawResources method. Therefore, LoadRawResources should be called first
138 * before this method is called.
140 void GenerateResources(Options::Type options = Options::None);
143 ResourceRefCounts mReferenceCounts;
144 EnvironmentDefinition::Vector mEnvironmentMaps;
145 ShaderDefinition::Vector mShaders;
146 MeshDefinition::Vector mMeshes;
147 MaterialDefinition::Vector mMaterials;
149 SkeletonDefinition::Vector mSkeletons;
150 BufferDefinition::Vector mBuffers;
152 bool mRawResourcesLoading;
153 bool mResourcesGenerating;
155 bool mRawResourcesLoaded;
156 bool mResourcesGenerated;
159 } // namespace Dali::Scene3D::Loader
161 #endif //DALI_SCENE3D_LOADERERERER_RESOURCE_BUNDLE_H_