+/**
+ * @brief Returns length of XHTML entity by parsing the text. It also determines if it is XHTML entity or not.
+ *
+ * @param[in] markupStringBuffer The mark-up string buffer. It's a const iterator pointing the current character.
+ * @param[in] markupStringEndBuffer Pointing to end of mark-up string buffer.
+ *
+ * @return Length of markupText in case of XHTML entity otherwise return 0.
+ */
+unsigned int GetXHTMLEntityLength( const char*& markupStringBuffer,
+ const char* const markupStringEndBuffer )
+{
+ char character = *markupStringBuffer;
+ if( AMPERSAND == character ) // '&'
+ {
+ // if the iterator is pointing to a '&' character, then check for ';' to find end to XHTML entity.
+ ++markupStringBuffer;
+ if( markupStringBuffer < markupStringEndBuffer )
+ {
+ unsigned int len = 1u;
+ for( ; markupStringBuffer < markupStringEndBuffer ; ++markupStringBuffer )
+ {
+ character = *markupStringBuffer;
+ ++len;
+ if( SEMI_COLON == character ) // ';'
+ {
+ // found end of XHTML entity
+ ++markupStringBuffer;
+ return len;
+ }
+ else if( ( AMPERSAND == character ) || ( BACK_SLASH == character ) || ( LESS_THAN == character ))
+ {
+ return 0;
+ }
+ }
+ }
+ }
+ return 0;
+}
+
+/**
+ * @brief It parses a XHTML string which has hex/decimal entity and fill its corresponging utf-8 string.
+ *
+ * @param[in] markupText The mark-up text buffer.
+ * @param[out] utf-8 text Corresponding to markup Text
+ *
+ * @return true if string is successfully parsed otherwise false
+ */
+bool XHTMLNumericEntityToUtf8 ( const char* markupText, char* utf8 )
+{
+ bool result = false;
+
+ if( NULL != markupText )
+ {
+ bool isHex = false;
+
+ // check if hex or decimal entity
+ if( ( CHAR_ARRAY_END != *markupText ) && ( HEX_CODE == *markupText ) )
+ {
+ isHex = true;
+ ++markupText;
+ }
+
+ char* end = NULL;
+ unsigned long l = strtoul( markupText, &end, ( isHex ? 16 : 10 ) ); // l contains UTF-32 code in case of correct XHTML entity
+
+ // check for valid XHTML numeric entities (between '#' or "#x" and ';')
+ if( ( l > 0 ) && ( l < ULONG_MAX ) && ( *end == SEMI_COLON ) ) // in case wrong XHTML entity is set eg. "abcdefs;" in that case *end will be 'a'
+ {
+ /* characters XML 1.1 permits */
+ if( ( ( XHTML_DECIMAL_ENTITY_RANGE[0] < l ) && ( l <= XHTML_DECIMAL_ENTITY_RANGE[1] ) ) ||
+ ( ( XHTML_DECIMAL_ENTITY_RANGE[2] <= l ) && ( l <= XHTML_DECIMAL_ENTITY_RANGE[3] ) ) ||
+ ( ( XHTML_DECIMAL_ENTITY_RANGE[4] <= l ) && ( l <= XHTML_DECIMAL_ENTITY_RANGE[5] ) ) )
+ {
+ // Convert UTF32 code to UTF8
+ Utf32ToUtf8( reinterpret_cast<const uint32_t* const>( &l ), 1, reinterpret_cast<uint8_t*>( utf8 ) );
+ result = true;
+ }
+ }
+ }
+ return result;
+}
+
+/**
+ * @brief Processes a particular tag for the required run (color-run or font-run).
+ *
+ * @tparam RunType Whether ColorRun or FontDescriptionRun
+ *
+ * @param[in/out] runsContainer The container containing all the runs
+ * @param[in/out] styleStack The style stack
+ * @param[in] tag The tag we are currently processing
+ * @param[in] characterIndex The current character index
+ * @param[in/out] runIndex The run index
+ * @param[in/out] tagReference The tagReference we should increment/decrement
+ * @param[in] parameterSettingFunction This function will be called to set run specific parameters
+ */
+template <typename RunType>
+void ProcessTagForRun(
+ Vector<RunType>& runsContainer,
+ StyleStack& styleStack,
+ const Tag& tag,
+ const CharacterIndex characterIndex,
+ StyleStack::RunIndex& runIndex,
+ int& tagReference,
+ std::function<void (const Tag&, RunType&)> parameterSettingFunction)
+{
+ if( !tag.isEndTag )
+ {
+ // Create a new run.
+ RunType run;
+ Initialize(run);
+
+ // Fill the run with the parameters.
+ run.characterRun.characterIndex = characterIndex;
+ parameterSettingFunction(tag, run);
+
+ // Push the run in the logical model.
+ runsContainer.PushBack(run);
+
+ // Push the index of the run into the stack.
+ styleStack.Push(runIndex);
+
+ // Point the next free run.
+ ++runIndex;
+
+ // Increase reference
+ ++tagReference;
+ }
+ else
+ {
+ if( tagReference > 0 )
+ {
+ // Pop the top of the stack and set the number of characters of the run.
+ RunType& run = *( runsContainer.Begin() + styleStack.Pop() );
+ run.characterRun.numberOfCharacters = characterIndex - run.characterRun.characterIndex;
+ --tagReference;
+ }
+ }
+}
+
+/**
+ * @brief Processes the item tag
+ *
+ * @param[in/out] markupProcessData The markup process data
+ * @param[in] tag The current tag
+ * @param[in/out] characterIndex The current character index
+ */
+void ProcessItemTag(
+ MarkupProcessData& markupProcessData,
+ const Tag tag,
+ CharacterIndex& characterIndex)
+{
+ if (tag.isEndTag)
+ {
+ // Create an embedded item instance.
+ EmbeddedItem item;
+ item.characterIndex = characterIndex;
+ ProcessEmbeddedItem(tag, item);
+
+ markupProcessData.items.PushBack(item);
+
+ // Insert white space character that will be replaced by the item.
+ markupProcessData.markupProcessedText.append( 1u, WHITE_SPACE );
+ ++characterIndex;
+ }
+}
+
+/**
+ * @brief Resizes the model's vectors
+ *
+ * @param[in/out] markupProcessData The markup process data
+ * @param[in] fontRunIndex The font run index
+ * @param[in] colorRunIndex The color run index
+ */
+void ResizeModelVectors(MarkupProcessData& markupProcessData, const StyleStack::RunIndex fontRunIndex, const StyleStack::RunIndex colorRunIndex)
+{
+ markupProcessData.fontRuns.Resize( fontRunIndex );
+ markupProcessData.colorRuns.Resize( colorRunIndex );
+
+#ifdef DEBUG_ENABLED
+ for( unsigned int i=0; i<colorRunIndex; ++i )
+ {
+ ColorRun& run = markupProcessData.colorRuns[i];
+ DALI_LOG_INFO( gLogFilter, Debug::Verbose, "run[%d] index: %d, length: %d, color %f,%f,%f,%f\n", i, run.characterRun.characterIndex, run.characterRun.numberOfCharacters, run.color.r, run.color.g, run.color.b, run.color.a );
+ }
+#endif
+}
+
+/**
+ * @brief Processes the markup string buffer
+ *
+ * @param[in/out] markupProcessData The markup process data
+ * @param[in/out] markupStringBuffer The markup string buffer pointer
+ * @param[in] markupStringEndBuffer The markup string end buffer pointer
+ * @param[in/out] characterIndex The current character index
+ */
+void ProcessMarkupStringBuffer(
+ MarkupProcessData& markupProcessData,
+ const char*& markupStringBuffer,
+ const char* const markupStringEndBuffer,
+ CharacterIndex& characterIndex)
+{
+ unsigned char character = *markupStringBuffer;
+ const char* markupBuffer = markupStringBuffer;
+ unsigned char count = GetUtf8Length( character );
+ char utf8[8];
+
+ if( ( BACK_SLASH == character ) && ( markupStringBuffer + 1u < markupStringEndBuffer ) )
+ {
+ // Adding < , > or & special character.
+ const unsigned char nextCharacter = *( markupStringBuffer + 1u );
+ if( ( LESS_THAN == nextCharacter ) || ( GREATER_THAN == nextCharacter ) || ( AMPERSAND == nextCharacter ) )
+ {
+ character = nextCharacter;
+ ++markupStringBuffer;
+
+ count = GetUtf8Length( character );
+ markupBuffer = markupStringBuffer;
+ }
+ }
+ else // checking if contains XHTML entity or not
+ {
+ const unsigned int len = GetXHTMLEntityLength( markupStringBuffer, markupStringEndBuffer);
+
+ // Parse markupStringTxt if it contains XHTML Entity between '&' and ';'
+ if( len > 0 )
+ {
+ char* entityCode = NULL;
+ bool result = false;
+ count = 0;
+
+ // Checking if XHTML Numeric Entity
+ if( HASH == *( markupBuffer + 1u ) )
+ {
+ entityCode = &utf8[0];
+ // markupBuffer is currently pointing to '&'. By adding 2u to markupBuffer it will point to numeric string by skipping "&#'
+ result = XHTMLNumericEntityToUtf8( ( markupBuffer + 2u ), entityCode );
+ }
+ else // Checking if XHTML Named Entity
+ {
+ entityCode = const_cast<char*> ( NamedEntityToUtf8( markupBuffer, len ) );
+ result = ( entityCode != NULL );
+ }
+ if ( result )
+ {
+ markupBuffer = entityCode; //utf8 text assigned to markupBuffer
+ character = markupBuffer[0];
+ }
+ else
+ {
+ DALI_LOG_INFO( gLogFilter, Debug::Verbose, "Not valid XHTML entity : (%.*s) \n", len, markupBuffer );
+ markupBuffer = NULL;
+ }
+ }
+ else // in case string conatins Start of XHTML Entity('&') but not its end character(';')
+ {
+ if( character == AMPERSAND )
+ {
+ markupBuffer = NULL;
+ DALI_LOG_INFO( gLogFilter, Debug::Verbose, "Not Well formed XHTML content \n" );
+ }
+ }
+ }
+
+ if( markupBuffer != NULL )
+ {
+ const unsigned char numberOfBytes = GetUtf8Length( character );
+ markupProcessData.markupProcessedText.push_back( character );
+
+ for( unsigned char i = 1u; i < numberOfBytes; ++i )
+ {
+ ++markupBuffer;
+ markupProcessData.markupProcessedText.push_back( *markupBuffer );
+ }
+
+ ++characterIndex;
+ markupStringBuffer += count;
+ }
+}
+