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=ef50b77bbb7de90b8325ff1247be1e44cb9b07c7;hb=cc7137614f4136f571ccecc22ad1b72c01f16156;hpb=aeef40d5dd70c7d878c7664986913ef2c6675a03 diff --git a/dali-toolkit/internal/text/text-scroller.h b/dali-toolkit/internal/text/text-scroller.h index ef50b77..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) 2016 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,19 +22,19 @@ #include #include #include +#include // INTERNAL INCLUDES #include +#include +#include namespace Dali { - namespace Toolkit { - namespace Text { - class TextScroller; class ScrollerInterface; @@ -46,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 ); + 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 @@ -83,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 @@ -95,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 @@ -104,23 +106,39 @@ public: int GetLoopCount() const; /** - * @brief Get the camera used to look at source, should be added to the parent of target actor. - * @return camera Actor + * @brief Set the delay time of scroll animation loop + * @param[in] float delay time seconds of loops */ - Actor GetSourceCamera() const; + void SetLoopDelay(float delay); /** - * @brief Get the resulting scrolling text actor, add to target actor which will show scrolling text - * @return mesh Actor + * @brief Get the delay time of scroll + * @return float delay time seconds of loops */ - Actor GetScrollingText() const; + float GetLoopDelay() const; -private: // Implementation + /** + * @brief Set the mode of scrolling stop + * @param[in] stopMode type when text scrolling is stoped. + */ + void SetStopMode(TextLabel::AutoScrollStopMode::Type stopMode); + + /** + * @brief Stop the auto scrolling. + */ + void StopScrolling(); /** + * @brief Get the mode of scrolling stop + * @return stopMode type when text scrolling is stoped. + */ + TextLabel::AutoScrollStopMode::Type GetStopMode() const; + +private: // Implementation + /** * Constructor */ - TextScroller( ScrollerInterface& scrollerInterface ); + TextScroller(ScrollerInterface& scrollerInterface); /** * Destructor @@ -128,42 +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 - int mWrapGap; ///< Gap before text wraps around when scrolling + 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 @@ -173,5 +188,4 @@ private: } // namespace Dali -#endif // __DALI_TOOLKIT_TEXT_SCROLLER_H__ - +#endif // DALI_TOOLKIT_TEXT_SCROLLER_H