1 #ifndef DALI_SCENE3D_LOADER_CUSTOMIZATION_STATE_H_
2 #define DALI_SCENE3D_LOADER_CUSTOMIZATION_STATE_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/api.h"
26 #include "dali/public-api/common/vector-wrapper.h"
35 * @brief Offers a description of an aspect of the scene that can be customized:
36 * the number of options, and the name of the nodes that are registered
37 * for the tag, whose children will be shown / hidden based on selection.
39 struct DALI_SCENE3D_API Customization
41 using Tag = std::string;
42 using OptionType = uint32_t;
45 * @brief A mapping of customizations to tags.
47 struct DALI_SCENE3D_API Map
53 * @brief Maps the given @a customization to the given @a tag, overwriting any previous mapping to the same tag.
54 * @return Pointer to the inserted (or pre-existing) Customization instance.
56 Customization* Set(Tag tag, Customization&& customization);
59 * @brief Attempts to retrieve a const Customization based on the given @a tag.
61 const Customization* Get(Tag tag) const;
64 * @brief Attempts to retrieve a Customization based on the given @a tag.
66 Customization* Get(Tag tag);
69 * @brief Returns the number of elements.
71 uint32_t Size() const;
74 * @brief Removes every element from the Map.
80 const std::unique_ptr<Impl> mImpl;
84 * @brief A mapping of choices - indices of children of customization nodes to use - to tags.
86 struct DALI_SCENE3D_API Choices
92 * @brief Maps the given @a option to the given @a tag, overwriting any previous mapping to the same tag.
94 void Set(Tag tag, OptionType option);
97 * @brief Attempts to retrieve a Customization based on the given @a tag. Returns NONE if @a tag is not known.
99 OptionType Get(Tag tag) const;
102 * @brief Returns the number of elements.
104 uint32_t Size() const;
107 * @brief Removes every element from the underlying map.
113 const std::unique_ptr<Impl> mImpl;
116 static const OptionType NONE = OptionType(-1);
118 OptionType numOptions = 0;
119 std::vector<std::string> nodes; // to apply option to.
122 } // namespace Loader
123 } // namespace Scene3D
126 #endif //DALI_SCENE3D_LOADER_CUSTOMIZATION_STATE_H_