X-Git-Url: http://review.tizen.org/git/?p=platform%2Fcore%2Fuifw%2Fdali-toolkit.git;a=blobdiff_plain;f=dali-toolkit%2Finternal%2Ftext%2Fmarkup-processor-helper-functions.h;h=490e51fc3e9517ab825d0763b6f4666a131898e7;hp=62be6c858c2f351db985d011b607a46dec9d1e92;hb=00758f1301dd0bfbf6dc87659a6db9d0ba2c6816;hpb=4d763eb68b5aa2448dfc81d90fc5ce598c68c99f diff --git a/dali-toolkit/internal/text/markup-processor-helper-functions.h b/dali-toolkit/internal/text/markup-processor-helper-functions.h index 62be6c8..490e51f 100644 --- a/dali-toolkit/internal/text/markup-processor-helper-functions.h +++ b/dali-toolkit/internal/text/markup-processor-helper-functions.h @@ -1,8 +1,8 @@ -#ifndef __DALI_TOOLKIT_TEXT_MARKUP_PROCESSOR_HELPER_FUNCTIONS_H__ -#define __DALI_TOOLKIT_TEXT_MARKUP_PROCESSOR_HELPER_FUNCTIONS_H__ +#ifndef DALI_TOOLKIT_TEXT_MARKUP_PROCESSOR_HELPER_FUNCTIONS_H +#define DALI_TOOLKIT_TEXT_MARKUP_PROCESSOR_HELPER_FUNCTIONS_H /* - * Copyright (c) 2015 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. @@ -27,15 +27,13 @@ namespace Dali { - +struct Vector2; struct Vector4; namespace Toolkit { - namespace Text { - /** * @brief Stores an attribute pair: name, value. */ @@ -43,20 +41,20 @@ struct Attribute { const char* nameBuffer; const char* valueBuffer; - Length nameLength; - Length valueLength; + Length nameLength; + Length valueLength; }; /** * @brief Stores a tag and its attributes. */ - struct Tag - { - Vector attributes; - const char* buffer; - Length length; - bool isEndTag; - }; +struct Tag +{ + Vector attributes; + const char* buffer; + Length length; + bool isEndTag; +}; /** * @brief Compare if two tokens are equal. @@ -73,16 +71,34 @@ struct Attribute * * @return @e true if both strings are equal. */ -bool TokenComparison( const std::string& string1, const char* const stringBuffer2, Length length ); +bool TokenComparison(const std::string& string1, const char* const stringBuffer2, Length length); /** * @brief Skips any unnecessary white space. * - * @param[in,out] markupStringBuffer The mark-up string buffer. It's a const iterator pointing the current character. - * @param[in] markupStringEndBuffer Pointer to one character after the end of the mark-up string buffer. + * @param[in,out] stringBuffer The string buffer. It's a const iterator pointing the current character. + * @param[in] stringEndBuffer Pointer to one character after the end of the string buffer. + */ +void SkipWhiteSpace(const char*& stringBuffer, + const char* const stringEndBuffer); + +/** + * @Brief Jumps to the next white space. + * + * @param[in,out] stringBuffer The string buffer. It's a const iterator pointing the current character. + * @param[in] stringEndBuffer Pointer to one character after the end of the string buffer. */ -void SkipWhiteSpace( const char*& markupStringBuffer, - const char* const markupStringEndBuffer ); +void JumpToWhiteSpace(const char*& stringBuffer, + const char* const stringEndBuffer); + +/** +* @brief Converts a string into an unsigned int. +* +* @param[in] uintStr An unsigned int packed inside a string. +* +* @return The unsigned int value. +*/ +unsigned int StringToUint(const char* const uintStr); /** * @brief Converts a string into an hexadecimal unsigned int. @@ -91,7 +107,7 @@ void SkipWhiteSpace( const char*& markupStringBuffer, * * @return The hexadecimal value. */ -unsigned int StringToHex( const char* const uintStr ); +unsigned int StringToHex(const char* const uintStr); /** * @brief Converts a string into a float value. @@ -100,7 +116,23 @@ unsigned int StringToHex( const char* const uintStr ); * * @return The float value. */ -float StringToFloat( const char* const floatStr ); +float StringToFloat(const char* const floatStr); + +/** + * @brief Converts a float into a string. + * + * @param[in] value The float value. + * @param[out] floatStr The string. + */ +void FloatToString(float value, std::string& floatStr); + +/** + * @brief Converts an unsigned int into a string. + * + * @param[in] value The unsigned int value. + * @param[out] uIntStr The string. + */ +void UintToString(unsigned int value, std::string& uIntStr); /** * @brief Converts an ARGB color packed in 4 byte unsigned int into a Vector4 color used in Dali. @@ -108,19 +140,48 @@ float StringToFloat( const char* const floatStr ); * @param[in] color An ARGB color packed in an unsigned int. * @param[out] retColor A Vector4 with the converted color. */ -void UintColorToVector4( unsigned int color, Vector4& retColor ); +void UintColorToVector4(unsigned int color, Vector4& retColor); /** * @brief Converts a color packed inside a string into an ARGB Vector4 color. * * The string color could be in hexadecimal ( 0xFF0000FF ), webcolor ( #0000FF or #00F ) or some constant values: - * black, white, red, green, blue, yellow, magenta, cyan, transparent. + * black, white, red, green, blue, yellow, magenta, cyan or transparent. * * @param[in] colorStr A color packed inside a string. * @param[in] length The length of the color string. * @param[out] retColor A color packed inside a Vector4. */ -void ColorStringToVector4( const char* const colorStr, Length length, Vector4& retColor ); +void ColorStringToVector4(const char* const colorStr, Length length, Vector4& retColor); + +/** + * @brief Converts a color packed in a Vector4 into a string. + * + * Constant colors will be converted to the strings black, white, red, green, blue, yellow, magenta, cyan or transparent. + * + * If is not a constant color it will be converted to a string with hexadecimal ARGB content. + * + * @param[in] value The color value. + * @param[out] colorStr The string. + */ +void Vector4ToColorString(const Vector4& value, std::string& vector2Str); + +/** + * @brief Converts a two dimension vector packed inside a string into a Vector2. + * + * @param[in] vectorStr The two dimension vector packed inside a string. + * @param[in] length The length of the string. + * @param[out] vector2 The Vector2. + */ +void StringToVector2(const char* const vectorStr, Length length, Vector2& vector2); + +/** + * @brief Converts a Vector2 into a string. + * + * @param[in] value The vector2 value. + * @param[out] vector2Str The string. + */ +void Vector2ToString(const Vector2& value, std::string& vector2Str); } // namespace Text @@ -128,4 +189,4 @@ void ColorStringToVector4( const char* const colorStr, Length length, Vector4& r } // namespace Dali -#endif // __DALI_TOOLKIT_TEXT_MARKUP_PROCESSOR_HELPER_FUNCTIONS_H__ +#endif // DALI_TOOLKIT_TEXT_MARKUP_PROCESSOR_HELPER_FUNCTIONS_H