X-Git-Url: http://review.tizen.org/git/?p=platform%2Fcore%2Fuifw%2Fdali-toolkit.git;a=blobdiff_plain;f=dali-toolkit%2Finternal%2Ftext%2Ftext-scroller.h;h=b93c2d212cb13f1eb0a43ea8bdc6336b3ea3df52;hp=2d611bbd8e6257fd45b40f886931a7aa602ff8b1;hb=750fadba87bb959c9af32e89e3f1bc7af6cb6dd2;hpb=30b39930a88d3d44cfea9a969c742d662666b149 diff --git a/dali-toolkit/internal/text/text-scroller.h b/dali-toolkit/internal/text/text-scroller.h index 2d611bb..b93c2d2 100644 --- a/dali-toolkit/internal/text/text-scroller.h +++ b/dali-toolkit/internal/text/text-scroller.h @@ -1,8 +1,8 @@ -#ifndef __DALI_TOOLKIT_TEXT_SCROLLER_H__ -#define __DALI_TOOLKIT_TEXT_SCROLLER_H__ +#ifndef DALI_TOOLKIT_TEXT_SCROLLER_H +#define DALI_TOOLKIT_TEXT_SCROLLER_H /* - * Copyright (c) 2017 Samsung Electronics Co., Ltd. + * Copyright (c) 2021 Samsung Electronics Co., Ltd. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -22,21 +22,19 @@ #include #include #include +#include // INTERNAL INCLUDES -#include #include -#include +#include +#include namespace Dali { - namespace Toolkit { - namespace Text { - class TextScroller; class ScrollerInterface; @@ -48,32 +46,34 @@ typedef IntrusivePtr TextScrollerPtr; class TextScroller : public RefObject, public ConnectionTracker { public: - /** * @brief Text Scrolling helper, used to automatically scroll text, SetParameters should be called before scrolling is needed. * CleanUp removes the Scrolling actors from stage whilst keeping the Scroller object alive and preserving Speed, Gap and Loop count. * * @param[in] scrollerInterface scroller interface */ - static TextScrollerPtr New( ScrollerInterface& scrollerInterface ); + static TextScrollerPtr New(ScrollerInterface& scrollerInterface); /** * @brief Set parameters relating to source required for scrolling * - * @param[in] sourceActor source actor to be scrolled + * @param[in] scrollingTextActor actor containing the text to be scrolled + * @param[in] renderer renderer to render the text + * @param[in] textureSet texture of the text to be scrolled * @param[in] controlSize size of the control to scroll within - * @param[in] offScreenSize size of the sourceActor + * @param[in] textureSize size of the texture + * @param[in] wrapGap The gap before scrolling wraps * @param[in] direction text direction true for right to left text - * @param[in] alignmentOffset alignment of source text - * + * @param[in] horizontalAlignment horizontal alignment of the text + * @param[in] verticalAlignment vertical alignment of the text */ - void SetParameters( Actor sourceActor, const Size& controlSize, const Size& offScreenSize, CharacterDirection direction, float alignmentOffset, Layout::HorizontalAlignment horizontalAlignment ); + void SetParameters(Actor scrollingTextActor, Dali::Renderer renderer, TextureSet textureSet, const Size& controlSize, const Size& textureSize, const float wrapGap, CharacterDirection direction, HorizontalAlignment::Type horizontalAlignment, VerticalAlignment::Type verticalAlignment); /** * @brief Set the gap distance to elapse before the text wraps around * @param[in] gap distance to elapse */ - void SetGap( int gap ); + void SetGap(int gap); /** * @brief Get the distance before scrolling wraps @@ -85,7 +85,7 @@ public: * @brief Set speed the text should scroll * @param[in] scrollSpeed pixels per second */ - void SetSpeed( int scrollSpeed ); + void SetSpeed(int scrollSpeed); /** * @brief Get the speed of text scrolling @@ -97,7 +97,7 @@ public: * @brief Set the number of times the text scrolling should loop, can stop current scrolling by passing in 0; * @param[in] loopCount number of times the scrolled text should loop, 0 to stop scrolling */ - void SetLoopCount( int loopCount ); + void SetLoopCount(int loopCount); /** * @brief Get the number of loops @@ -109,7 +109,7 @@ public: * @brief Set the delay time of scroll animation loop * @param[in] float delay time seconds of loops */ - void SetLoopDelay( float delay ); + void SetLoopDelay(float delay); /** * @brief Get the delay time of scroll @@ -121,7 +121,7 @@ public: * @brief Set the mode of scrolling stop * @param[in] stopMode type when text scrolling is stoped. */ - void SetStopMode( DevelTextLabel::AutoScrollStopMode::Type stopMode ); + void SetStopMode(TextLabel::AutoScrollStopMode::Type stopMode); /** * @brief Stop the auto scrolling. @@ -132,26 +132,13 @@ public: * @brief Get the mode of scrolling stop * @return stopMode type when text scrolling is stoped. */ - DevelTextLabel::AutoScrollStopMode::Type GetStopMode() const; - - /** - * @brief Get the camera used to look at source, should be added to the parent of target actor. - * @return camera Actor - */ - Actor GetSourceCamera() const; - - /** - * @brief Get the resulting scrolling text actor, add to target actor which will show scrolling text - * @return mesh Actor - */ - Actor GetScrollingText() const; + TextLabel::AutoScrollStopMode::Type GetStopMode() const; private: // Implementation - /** * Constructor */ - TextScroller( ScrollerInterface& scrollerInterface ); + TextScroller(ScrollerInterface& scrollerInterface); /** * Destructor @@ -159,44 +146,39 @@ private: // Implementation ~TextScroller(); // Undefined - TextScroller( const TextScroller& handle ); + TextScroller(const TextScroller& handle); // Undefined - TextScroller& operator=( const TextScroller& handle ); + TextScroller& operator=(const TextScroller& handle); /** * @brief Callback for end of animation * @param[in] animation Animation handle */ - void AutoScrollAnimationFinished( Dali::Animation& animation ); + void AutoScrollAnimationFinished(Dali::Animation& animation); /** * @brief variables required to set up scrolling animation + * @param[in] scrollingTextActor actor that shows scrolling text * @param[in] scrollAmount distance to animate text for the given duration * @param[in] scrollDuration duration of aninmation * @param[in] loopCount number of times to loop the scrolling text */ - void StartScrolling( float scrollAmount, float scrollDuration, int loopCount ); - - /** - * @brief When scrolling ended, the actors are cleaned up so no longer staged. - */ - void CleanUp(); + void StartScrolling(Actor scrollingTextActor, float scrollAmount, float scrollDuration, int loopCount); private: - - RenderTask mRenderTask; // Renders full text to a FrameBuffer which is then scrolled. - CameraActor mOffscreenCameraActor; // Camera used by render task - Actor mScrollingTextActor; // Actor used to show scrolling text - ScrollerInterface& mScrollerInterface; // Interface implemented by control that requires scrolling - Property::Index mScrollDeltaIndex; // Property used by shader to represent distance to scroll - Animation mScrollAnimation; // Animation used to update the mScrollDeltaIndex - - int mScrollSpeed; ///< Speed which text should automatically scroll at - int mLoopCount; ///< Number of time the text should scroll - float mLoopDelay; ///< Time delay of loop start - float mWrapGap; ///< Gap before text wraps around when scrolling - DevelTextLabel::AutoScrollStopMode::Type mStopMode; ///< Stop mode of scrolling text, when loop count is 0. + ScrollerInterface& mScrollerInterface; // Interface implemented by control that requires scrolling + Property::Index mScrollDeltaIndex; // Property used by shader to represent distance to scroll + Animation mScrollAnimation; // Animation used to update the mScrollDeltaIndex + Dali::Renderer mRenderer; // Renderer used to render the text + Shader mShader; // Shader originally used by the renderer while not scrolling + TextureSet mTextureSet; // Texture originally used by the renderer while not scrolling + + int mScrollSpeed; ///< Speed which text should automatically scroll at + int mLoopCount; ///< Number of time the text should scroll + float mLoopDelay; ///< Time delay of loop start + float mWrapGap; ///< Gap before text wraps around when scrolling + TextLabel::AutoScrollStopMode::Type mStopMode; ///< Stop mode of scrolling text, when loop count is 0. }; // TextScroller class @@ -206,5 +188,4 @@ private: } // namespace Dali -#endif // __DALI_TOOLKIT_TEXT_SCROLLER_H__ - +#endif // DALI_TOOLKIT_TEXT_SCROLLER_H