X-Git-Url: http://review.tizen.org/git/?p=platform%2Fcore%2Fuifw%2Fdali-toolkit.git;a=blobdiff_plain;f=dali-toolkit%2Finternal%2Fvisuals%2Ftext%2Ftext-visual.h;h=05d158586cafc344c1c660cc8007b7b53eeabaf5;hp=ebeb867edf87f1c0b137bbe44c440b6cad834d51;hb=c93f6281a8bafc5b7ba5f0dcdad0eb675b8e3436;hpb=1063a6000706a2212f12497bb09113d1633ea436 diff --git a/dali-toolkit/internal/visuals/text/text-visual.h b/dali-toolkit/internal/visuals/text/text-visual.h index ebeb867..05d1585 100644 --- a/dali-toolkit/internal/visuals/text/text-visual.h +++ b/dali-toolkit/internal/visuals/text/text-visual.h @@ -2,7 +2,7 @@ #define DALI_TOOLKIT_INTERNAL_TEXT_VISUAL_H /* - * Copyright (c) 2016 Samsung Electronics Co., Ltd. + * Copyright (c) 2022 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. @@ -18,22 +18,26 @@ * */ +// EXTERNAL INCLUDES +#include +#include +#include +#include + // INTERNAL INCLUDES -#include #include #include +#include +#include namespace Dali { - namespace Toolkit { - namespace Internal { - class TextVisual; -typedef IntrusivePtr< TextVisual > TextVisualPtr; +typedef IntrusivePtr TextVisualPtr; /** * The visual which renders text @@ -60,76 +64,180 @@ typedef IntrusivePtr< TextVisual > TextVisualPtr; * | underline | STRING | * | shadow | STRING | * | outline | STRING | - * | batchingEnabled | BOOLEAN | * */ class TextVisual : public Visual::Base { public: - /** * @brief Create a new text visual. * * @param[in] factoryCache A pointer pointing to the VisualFactoryCache object + * @param[in] shaderFactory The TextVisualShaderFactory object * @param[in] properties A Property::Map containing settings for this visual * @return A smart-pointer to the newly allocated visual. */ - static TextVisualPtr New( VisualFactoryCache& factoryCache, const Property::Map& properties ); + static TextVisualPtr New(VisualFactoryCache& factoryCache, TextVisualShaderFactory& shaderFactory, const Property::Map& properties); -public: // from Visual::Base + /** + * @brief Converts all strings keys in property map to index keys. Property Map can then be merged correctly. + * @param[in] propertyMap containing string keys or a mix of strings and indexes. + * @return Property::Map containing index keys. + */ + static Property::Map ConvertStringKeysToIndexKeys(const Property::Map& propertyMap); + + /** + * @brief Retrieve the text's controller. + * @param[in] visual The text visual. + * @return The text controller + */ + static Text::ControllerPtr GetController(Toolkit::Visual::Base visual) + { + return GetVisualObject(visual).mController; + }; + + /** + * @brief Set the index of the animatable text color property. + * @param[in] visual The text visual. + * @param[in] animatablePropertyIndex The index of the animatable property + */ + static void SetAnimatableTextColorProperty(Toolkit::Visual::Base visual, Property::Index animatablePropertyIndex) + { + GetVisualObject(visual).mAnimatableTextColorPropertyIndex = animatablePropertyIndex; + }; /** + * @brief Set the flag to trigger the textures to be initialized and renderer to be added to the control. + * @param[in] visual The text visual. + */ + static void EnableRendererUpdate(Toolkit::Visual::Base visual) + { + GetVisualObject(visual).mRendererUpdateNeeded = true; + }; + + /** + * @brief Instantly updates the renderer + * @param[in] visual The text visual. + */ + static void UpdateRenderer(Toolkit::Visual::Base visual) + { + GetVisualObject(visual).UpdateRenderer(); + }; + +public: // from Visual::Base + /** * @copydoc Visual::Base::GetHeightForWidth() */ - virtual float GetHeightForWidth( float width ); + float GetHeightForWidth(float width) override; /** * @copydoc Visual::Base::GetNaturalSize() */ - virtual void GetNaturalSize( Vector2& naturalSize ); + void GetNaturalSize(Vector2& naturalSize) override; /** * @copydoc Visual::Base::CreatePropertyMap() */ - virtual void DoCreatePropertyMap( Property::Map& map ) const; + void DoCreatePropertyMap(Property::Map& map) const override; -protected: + /** + * @copydoc Visual::Base::CreateInstancePropertyMap + */ + void DoCreateInstancePropertyMap(Property::Map& map) const override; /** + * @copydoc Visual::Base::EnablePreMultipliedAlpha + */ + void EnablePreMultipliedAlpha(bool preMultiplied) override; + +protected: + /** * @brief Constructor. * * @param[in] factoryCache The VisualFactoryCache object + * @param[in] shaderFactory The TextVisualShaderFactory object */ - TextVisual( VisualFactoryCache& factoryCache ); + TextVisual(VisualFactoryCache& factoryCache, TextVisualShaderFactory& shaderFactory); /** * @brief A reference counted object may only be deleted by calling Unreference(). */ virtual ~TextVisual(); + /** + * @copydoc Visual::Base::OnInitialize + */ + void OnInitialize() override; + // from Visual::Base /** * @copydoc Visual::Base::DoSetProperties() */ - virtual void DoSetProperties( const Property::Map& propertyMap ); + void DoSetProperties(const Property::Map& propertyMap) override; /** - * @copydoc Visual::Base::DoSetOnStage() + * @copydoc Visual::Base::DoSetOnScene() */ - virtual void DoSetOnStage( Actor& actor ); + void DoSetOnScene(Actor& actor) override; /** - * @copydoc Visual::Base::DoSetOffStage() + * @copydoc Visual::Base::DoSetOffScene() */ - virtual void DoSetOffStage( Actor& actor ); + void DoSetOffScene(Actor& actor) override; /** * @copydoc Visual::Base::OnSetTransform */ - virtual void OnSetTransform(); + void OnSetTransform() override; private: + struct TilingInfo + { + unsigned char* textBuffer; + unsigned char* styleBuffer; + unsigned char* overlayStyleBuffer; + unsigned char* maskBuffer; + int width; + int height; + Pixel::Format textPixelFormat; + int offsetPosition; + Vector2 offSet; + + TilingInfo(int width, int height, Pixel::Format textPixelFormat) + : textBuffer(NULL), + styleBuffer(NULL), + overlayStyleBuffer(NULL), + maskBuffer(NULL), + width(width), + height(height), + textPixelFormat(textPixelFormat), + offsetPosition(0), + offSet(0.f, 0.f) + { + } + + ~TilingInfo() + { + if(textBuffer) + { + free(textBuffer); + } + if(styleBuffer) + { + free(styleBuffer); + } + if(overlayStyleBuffer) + { + free(overlayStyleBuffer); + } + if(maskBuffer) + { + free(maskBuffer); + } + } + }; + /** * @brief Set the individual property to the given value. * @@ -137,23 +245,96 @@ private: * * @param[in] propertyValue The value to set. */ - void DoSetProperty( Dali::Property::Index index, const Dali::Property::Value& propertyValue ); + void DoSetProperty(Dali::Property::Index index, const Dali::Property::Value& propertyValue); /** * @brief Updates the text's renderer. - * @param[in] initializeRendererAndTexture Set flag to true to initialize textures and add renderer to control. */ - void UpdateRenderer( bool initializeRendererAndTexture ); + void UpdateRenderer(); + + /** + * @brief Removes the text's renderer. + */ + void RemoveRenderer(Actor& actor); /** - * @brief Removes the texture set from the renderer. + * @brief Create a texture in textureSet and add it. + * @param[in] textureSet The textureSet to which the texture will be added. + * @param[in] data The PixelData to be uploaded to texture + * @param[in] sampler The sampler. + * @param[in] textureSetIndex The Index of TextureSet. */ - void RemoveTextureSet(); + void AddTexture(TextureSet& textureSet, PixelData& data, Sampler& sampler, unsigned int textureSetIndex); + + /** + * @brief Convert the buffer to pixelData. + * @param[in] buffer The Buffer to be converted to pixelData. + * @param[in] width The width of pixel data. + * @param[in] height The height of pixel data. + * @param[in] offsetPosition The The buffer's start position. + * @param[in] textPixelFormat The PixelForma of text. + */ + PixelData ConvertToPixelData(unsigned char* buffer, int width, int height, int offsetPosition, const Pixel::Format textPixelFormat); + + /** + * @brief Create the text's texture. It will use cached shader feature for text visual. + * @param[in] info This is the information you need to create a Tiling. + * @param[in] renderer The renderer to which the TextureSet will be added. + * @param[in] sampler The sampler. + */ + void CreateTextureSet(TilingInfo& info, VisualRenderer& renderer, Sampler& sampler); + + /** + * Create renderer of the text for rendering. + * @param[in] actor The actor. + * @param[in] size The texture size. + * @param[in] hasMultipleTextColors Whether the text contains multiple colors. + * @param[in] containsColorGlyph Whether the text contains color glyph. + * @param[in] styleEnabled Whether the text contains any styles (e.g. shadow, underline, etc.). + * @param[in] isOverlayStyle Whether the style needs to overlay on the text (e.g. strikethrough, underline, etc.). + */ + void AddRenderer(Actor& actor, const Vector2& size, bool hasMultipleTextColors, bool containsColorGlyph, bool styleEnabled, bool isOverlayStyle); + + /** + * Get the texture of the text for rendering. It will use cached shader feature for text visual. + * @param[in] size The texture size. + */ + TextureSet GetTextTexture(const Vector2& size); + + /** + * Get the text rendering shader. + * @param[in] factoryCache A pointer pointing to the VisualFactoryCache object + * @param[in] featureBuilder Collection of current text shader's features. It will be cached as text visual. + */ + Shader GetTextShader(VisualFactoryCache& factoryCache, const TextVisualShaderFeature::FeatureBuilder& featureBuilder); + + /** + * @brief Retrieve the TextVisual object. + * @param[in] visual A handle to the TextVisual + * @return The TextVisual object + */ + static TextVisual& GetVisualObject(Toolkit::Visual::Base visual) + { + return static_cast(Toolkit::GetImplementation(visual).GetVisualObject()); + }; + +private: + typedef std::vector RendererContainer; private: Text::ControllerPtr mController; ///< The text's controller. Text::TypesetterPtr mTypesetter; ///< The text's typesetter. - WeakHandle mControl; ///< The control where the renderer is added. + + TextVisualShaderFactory& mTextVisualShaderFactory; ///< The shader factory for text visual. + TextVisualShaderFeature::FeatureBuilder mTextShaderFeatureCache; ///< The cached shader feature for text visual. + + WeakHandle mControl; ///< The control where the renderer is added. + Constraint mColorConstraint{}; ///< Color constraint + Constraint mOpacityConstraint{}; ///< Opacity constraint + Property::Index mAnimatableTextColorPropertyIndex; ///< The index of animatable text color property registered by the control. + Property::Index mTextColorAnimatableIndex; ///< The index of uTextColorAnimatable property. + bool mRendererUpdateNeeded : 1; ///< The flag to indicate whether the renderer needs to be updated. + RendererContainer mRendererList; }; } // namespace Internal