1 #ifndef DALI_TOOLKIT_BUBBLE_EMMITER_H
2 #define DALI_TOOLKIT_BUBBLE_EMMITER_H
5 * Copyright (c) 2022 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/controls/control.h>
23 #include <dali/public-api/rendering/texture.h>
29 namespace Internal DALI_INTERNAL
32 * @brief BubbleEmitter implementation class.
35 } // namespace DALI_INTERNAL
38 * @brief BubbleEmitter is used to display lots of moving bubbles on the stage.
40 * This is done by applying BubbleEffect to multiple specifically created meshActors.
42 class DALI_TOOLKIT_API BubbleEmitter : public Control
46 * @brief Create an empty BubbleEmitter handle.
51 * @brief Virtual destructor.
56 * @brief Create an initialized BubbleEmitter.
58 * @param[in] winSize The size of the bubble moving area, usually the same size as the background.
59 * @param[in] shapeTexture The alpha channnel of this texture defines the bubble shape.
60 * @param[in] maximumNumberOfBubble The maximum number of bubble needed.
61 * @param[in] bubbleSizeRange The size range of the bubbles; x component is the low bound, and y component is the up bound.
62 * @return The initialized BubbleEmitter object.
64 static BubbleEmitter New(const Vector2& winSize,
65 Dali::Texture shapeTexture,
66 unsigned int maximumNumberOfBubble,
67 const Vector2& bubbleSizeRange);
70 * @brief Copy constructor.
72 * Creates another handle that points to the same real object
73 * @param[in] handle The handle to copy
75 BubbleEmitter(const BubbleEmitter& handle);
78 * @brief Assignment operator.
80 * Changes this handle to point to another real object
81 * @param[in] rhs The object to point at
82 * @return A reference to this
84 BubbleEmitter& operator=(const BubbleEmitter& rhs);
87 * @brief Move constructor.
89 * Creates another handle that points to the same real object
90 * @param[in] handle The handle to move
92 BubbleEmitter(BubbleEmitter&& handle);
95 * @brief Move assignment operator.
97 * Changes this handle to point to another real object
98 * @param[in] rhs The object to point at
99 * @return A reference to this
101 BubbleEmitter& operator=(BubbleEmitter&& rhs);
104 * @brief Downcast an Object handle to SuperBlurView.
106 * If handle points to a BubbleEmitter, the downcast produces valid handle.
107 * If not, the returned handle is left uninitialized.
108 * @param[in] handle Handle to an object
109 * @return handle to a BubbleEmitter or an uninitialized handle
111 static BubbleEmitter DownCast(BaseHandle handle);
114 * @brief Return the root actor of all bubbles, should then be added to stage.
116 * @return The bubble root actor.
118 Actor GetRootActor();
121 * @brief Set Background image.
123 * The bubbles pick color from this image with HSV values adjusted.
124 * @param[in] bgTexture The background texture which provide color to bubbles.
125 * @param[in] hsvDelta The hsv channel difference used to adjust the background image color.
126 * If set these vector as Vector3::Zero, original colors are used.
128 void SetBackground(Dali::Texture bgTexture, const Vector3& hsvDelta);
131 * @brief Set bubble shape.
133 * The bubble mesh is a rectangular patch, but its displayed shape is decided by the alpha channel of the shape texture.
134 * @param[in] shapeTexture The texture whose alpha channel defines the bubble shape.
136 void SetBubbleShape(Dali::Texture shapeTexture);
139 * @brief Set the scale factor applied to all the bubbles.
141 * @param [in] scale The scale factor applied on bubbles.
143 void SetBubbleScale(float scale);
146 * @brief Set the density of the bubble.
148 * Ideally every bubble's moving track is controlled by different uniforms in shader.
149 * To increase the density, 'density' number of bubbles are sharing one group of uniforms, but with random offsets between these bubbles.
150 * The available densities are one to nine only. The default value is five.
151 * By set the density bigger than one, instead of emit one bubble each time, a 'density' number of bubbles are emitted.
152 * @param[in] density The density of the bubble.
154 void SetBubbleDensity(unsigned int density);
157 * @brief Add a bubble movement to the animation.
159 * @param[in] animation The animation reference.
160 * By passing the animation into BubbleEmitter, the animation's duration and how many bubbles contained within this animation are freely decided in App.
161 * @param[in] emitPosition The start position of the bubble movement.
162 * @param[in] direction The direction used to constrain the bubble to move in an adjacent direction around it.
163 * @param[in] displacement The displacement used to bound the moving distance of the bubble.
165 void EmitBubble(Animation& animation, const Vector2& emitPosition, const Vector2& direction, const Vector2& displacement);
168 * @brief Reset all the parameters controlling the bubbles after animation.
172 public: // Not intended for developer use
174 * @brief Creates a handle using the Toolkit::Internal implementation.
176 * @param[in] implementation The Control implementation.
178 DALI_INTERNAL BubbleEmitter(Internal::BubbleEmitter& implementation);
181 * @brief Allows the creation of this Control from an Internal::CustomActor pointer.
183 * @param[in] internal A pointer to the internal CustomActor.
185 explicit DALI_INTERNAL BubbleEmitter(Dali::Internal::CustomActor* internal);
188 } // namespace Toolkit
192 #endif /* DALI_TOOLKIT_BUBBLE_EMMITER_H */