1 #ifndef DALI_TOOLKIT_DEVEL_API_VISUALS_IMAGE_VISUAL_PROPERTIES_DEVEL_H
2 #define DALI_TOOLKIT_DEVEL_API_VISUALS_IMAGE_VISUAL_PROPERTIES_DEVEL_H
5 * Copyright (c) 2020 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 <dali-toolkit/public-api/visuals/image-visual-properties.h>
28 namespace DevelImageVisual
34 URL = Dali::Toolkit::ImageVisual::Property::URL,
35 FITTING_MODE = Dali::Toolkit::ImageVisual::Property::FITTING_MODE,
36 SAMPLING_MODE = Dali::Toolkit::ImageVisual::Property::SAMPLING_MODE,
37 DESIRED_WIDTH = Dali::Toolkit::ImageVisual::Property::DESIRED_WIDTH,
38 DESIRED_HEIGHT = Dali::Toolkit::ImageVisual::Property::DESIRED_HEIGHT,
39 SYNCHRONOUS_LOADING = Dali::Toolkit::ImageVisual::Property::SYNCHRONOUS_LOADING,
40 BORDER_ONLY = Dali::Toolkit::ImageVisual::Property::BORDER_ONLY,
41 PIXEL_AREA = Dali::Toolkit::ImageVisual::Property::PIXEL_AREA,
42 WRAP_MODE_U = Dali::Toolkit::ImageVisual::Property::WRAP_MODE_U,
43 WRAP_MODE_V = Dali::Toolkit::ImageVisual::Property::WRAP_MODE_V,
44 BORDER = Dali::Toolkit::ImageVisual::Property::BORDER,
45 ATLASING = Dali::Toolkit::ImageVisual::Property::ATLASING,
46 ALPHA_MASK_URL = Dali::Toolkit::ImageVisual::Property::ALPHA_MASK_URL,
47 BATCH_SIZE = Dali::Toolkit::ImageVisual::Property::BATCH_SIZE,
48 CACHE_SIZE = Dali::Toolkit::ImageVisual::Property::CACHE_SIZE,
49 FRAME_DELAY = Dali::Toolkit::ImageVisual::Property::FRAME_DELAY,
50 MASK_CONTENT_SCALE = Dali::Toolkit::ImageVisual::Property::MASK_CONTENT_SCALE,
51 CROP_TO_MASK = Dali::Toolkit::ImageVisual::Property::CROP_TO_MASK,
52 LOAD_POLICY = Dali::Toolkit::ImageVisual::Property::LOAD_POLICY,
53 RELEASE_POLICY = Dali::Toolkit::ImageVisual::Property::RELEASE_POLICY,
54 ORIENTATION_CORRECTION = Dali::Toolkit::ImageVisual::Property::ORIENTATION_CORRECTION,
57 * @brief Overlays the auxiliary image on top of an NPatch image.
59 * The resulting visual image will be at least as large as the
60 * smallest possible n-patch or the auxiliary image, whichever is
63 * @details Name "auxiliaryImage", Type Property::STRING, URL of the image.
66 AUXILIARY_IMAGE = ORIENTATION_CORRECTION + 1,
69 * @brief An alpha value for mixing between the masked main NPatch image and the auxiliary image
70 * @details Name "auxiliaryImageAlpha", Type Property::FLOAT, between 0 and 1
73 AUXILIARY_IMAGE_ALPHA = ORIENTATION_CORRECTION + 2,
76 * @brief The number of times the AnimatedImageVisual or AnimatedVectorImageVisual will be looped.
77 * @details Name "loopCount", type Property::INTEGER.
78 * @note For Animated images only. Default -1. if < 0, loop unlimited. else, loop loopCount times.
80 LOOP_COUNT = ORIENTATION_CORRECTION + 3,
83 * @brief The playing range the AnimatedVectorImageVisual will use.
85 * Animation will play between the values specified. The array can have two integer values.
86 * Or it can have one or two strings, which are markers. More will be ignored.
87 * Both values should be between 0 and the total frame number, otherwise they will be ignored.
88 * If the range provided is not in proper order ( minimum, maximum ), it will be reordered.
90 * A marker has its start frame and end frame.
91 * Animation will play between the start frame and the end frame of the marker if one marker is specified.
92 * Or animation will play between the start frame of the first marker and the end frame of the second marker if two markers are specified.
94 * @details Name "playRange", Type Property::ARRAY of Property::INTEGER or Property::ARRAY of Property::STRING.
95 * @note Default 0 and the total frame number.
97 PLAY_RANGE = ORIENTATION_CORRECTION + 4,
100 * @brief The playing state the AnimatedVectorImageVisual will use.
101 * @details Name "playState", Type PlayState::Type (Property::INTEGER)
102 * @note This property is read-only.
104 PLAY_STATE = ORIENTATION_CORRECTION + 5,
107 * @brief The current frame number the AnimatedImageVisual and AnimatedVectorImageVisual will use.
108 * @details Name "currentFrameNumber", Type Property::INTEGER, between [0, the maximum frame number] or between the play range if specified
109 * @note This property is read-only.
111 CURRENT_FRAME_NUMBER = ORIENTATION_CORRECTION + 6,
114 * @brief The total frame number the AnimatedImageVisual and AnimatedVectorImageVisual will use.
115 * @details Name "totalFrameNumber", Type Property::INTEGER.
116 * @note This property is read-only.
118 TOTAL_FRAME_NUMBER = ORIENTATION_CORRECTION + 7,
121 * @brief The stop behavior the AnimatedImageVisual and AnimatedVectorImageVisual will use.
122 * @details Name "stopBehavior", Type StopBehavior::Type (Property::INTEGER)
123 * @note Default value is StopBehavior::CURRENT_FRAME.
125 STOP_BEHAVIOR = ORIENTATION_CORRECTION + 8,
128 * @brief The looping mode the AnimatedVectorImageVisual will use.
129 * @details Name "loopingMode", Type LoopingMode::Type (Property::INTEGER)
130 * @note Default value is LoopingMode::RESTART.
132 LOOPING_MODE = ORIENTATION_CORRECTION + 9,
135 * @brief The content information the AnimatedVectorImageVisual will use.
136 * @details Name "contentInfo", Type Property::MAP.
137 * The map contains the layer name as a key and Property::Array as a value.
138 * And the array contains 2 integer values which are the frame numbers, the start frame number and the end frame number of the layer.
139 * @note This property is read-only.
141 CONTENT_INFO = ORIENTATION_CORRECTION + 10,
144 * @brief Whether to redraw the image when the visual is scaled down.
145 * @details Name "redrawInScalingDown", type Property::BOOLEAN.
146 * @note It is used in the AnimatedVectorImageVisual. The default is true.
148 REDRAW_IN_SCALING_DOWN
151 } //namespace Property
154 * @brief Enumeration for what state the animation is in.
160 STOPPED, ///< Animation has stopped
161 PLAYING, ///< The animation is playing
162 PAUSED ///< The animation is paused
165 } // namespace PlayState
168 * @brief Enumeration for what to do when the animation is stopped.
170 namespace StopBehavior
174 CURRENT_FRAME, ///< When the animation is stopped, the current frame is shown.
175 FIRST_FRAME, ///< When the animation is stopped, the first frame is shown.
176 LAST_FRAME ///< When the animation is stopped, the last frame is shown.
179 } // namespace StopBehavior
182 * @brief Enumeration for what looping mode is in.
184 namespace LoopingMode
188 RESTART, ///< When the animation arrives at the end in looping mode, the animation restarts from the beginning.
189 AUTO_REVERSE ///< When the animation arrives at the end in looping mode, the animation reverses direction and runs backwards again.
192 } // namespace LoopingMode
194 } // namespace DevelImageVisual
196 } // namespace Toolkit
200 #endif // DALI_TOOLKIT_DEVEL_API_VISUALS_IMAGE_VISUAL_PROPERTIES_DEVEL_H