1 #ifndef DALI_SCENE_LOADER_CUSTOMIZATION_STATE_H_
2 #define DALI_SCENE_LOADER_CUSTOMIZATION_STATE_H_
4 * Copyright (c) 2020 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-scene-loader/public-api/api.h"
24 #include "dali/public-api/common/vector-wrapper.h"
34 * @brief Offers a description of an aspect of the scene that can be customized:
35 * the number of options, and the name of the nodes that are registered
36 * for the tag, whose children will be shown / hidden based on selection.
38 struct DALI_SCENE_LOADER_API Customization
40 using Tag = std::string;
41 using OptionType = uint32_t;
44 * @brief A mapping of customizations to tags.
46 struct DALI_SCENE_LOADER_API Map
52 * @brief Maps the given @a customization to the given @a tag, overwriting any previous mapping to the same tag.
53 * @return Pointer to the inserted (or pre-existing) Customization instance.
55 Customization* Set(Tag tag, Customization&& customization);
58 * @brief Attempts to retrieve a const Customization based on the given @a tag.
60 const Customization* Get(Tag tag) const;
63 * @brief Attempts to retrieve a Customization based on the given @a tag.
65 Customization* Get(Tag tag);
68 * @brief Returns the number of elements.
70 uint32_t Size() const;
73 * @brief Removes every element from the Map.
79 const std::unique_ptr<Impl> mImpl;
83 * @brief A mapping of choices - indices of children of customization nodes to use - to tags.
85 struct DALI_SCENE_LOADER_API Choices
91 * @brief Maps the given @a option to the given @a tag, overwriting any previous mapping to the same tag.
93 void Set(Tag tag, OptionType option);
96 * @brief Attempts to retrieve a Customization based on the given @a tag. Returns NONE if @a tag is not known.
98 OptionType Get(Tag tag) const;
101 * @brief Returns the number of elements.
103 uint32_t Size() const;
106 * @brief Removes every element from the underlying map.
112 const std::unique_ptr<Impl> mImpl;
115 static const OptionType NONE = OptionType(-1);
117 OptionType numOptions = 0;
118 std::vector<std::string> nodes; // to apply option to.
124 #endif //DALI_SCENE_LOADER_CUSTOMIZATION_STATE_H_