2 * Copyright (c) 2021 Samsung Electronics Co., Ltd.
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
19 #include <dali-toolkit/internal/text/cursor-helper-functions.h>
22 #include <dali/integration-api/debug.h>
25 #include <dali-toolkit/internal/text/glyph-metrics-helper.h>
29 #if defined(DEBUG_ENABLED)
30 Debug::Filter* gLogFilter = Debug::Filter::New(Debug::NoLogging, true, "LOG_TEXT_CONTROLS");
33 const Dali::Toolkit::Text::CharacterDirection LTR = false; ///< Left To Right direction.
37 FindWordData(const Dali::Toolkit::Text::Character* const textBuffer,
38 Dali::Toolkit::Text::Length totalNumberOfCharacters,
39 Dali::Toolkit::Text::CharacterIndex hitCharacter,
42 : textBuffer(textBuffer),
43 totalNumberOfCharacters(totalNumberOfCharacters),
44 hitCharacter(hitCharacter),
46 isWhiteSpace(isWhiteSpace),
47 isNewParagraph(isNewParagraph)
55 const Dali::Toolkit::Text::Character* const textBuffer;
56 Dali::Toolkit::Text::Length totalNumberOfCharacters;
57 Dali::Toolkit::Text::CharacterIndex hitCharacter;
58 Dali::Toolkit::Text::CharacterIndex foundIndex;
59 bool isWhiteSpace : 1u;
60 bool isNewParagraph : 1u;
63 bool IsWhiteSpaceOrNewParagraph(Dali::Toolkit::Text::Character character,
65 bool isHitWhiteSpaceOrNewParagraph)
67 bool isWhiteSpaceOrNewParagraph = false;
68 if(isHitWhiteSpaceOrNewParagraph)
72 // Whether the current character is a white space. Note a new paragraph character is a white space as well but here is not wanted.
73 isWhiteSpaceOrNewParagraph = Dali::TextAbstraction::IsWhiteSpace(character) && !Dali::TextAbstraction::IsNewParagraph(character);
77 // Whether the current character is a new paragraph character.
78 isWhiteSpaceOrNewParagraph = Dali::TextAbstraction::IsNewParagraph(character);
83 // Whether the current character is a white space or a new paragraph character (note the new paragraph character is a white space as well).
84 isWhiteSpaceOrNewParagraph = Dali::TextAbstraction::IsWhiteSpace(character);
87 return isWhiteSpaceOrNewParagraph;
90 void FindStartOfWord(FindWordData& data)
92 const bool isHitWhiteSpaceOrNewParagraph = data.isWhiteSpace || data.isNewParagraph;
94 for(data.foundIndex = data.hitCharacter; data.foundIndex > 0; --data.foundIndex)
96 const Dali::Toolkit::Text::Character character = *(data.textBuffer + data.foundIndex - 1u);
98 const bool isWhiteSpaceOrNewParagraph = IsWhiteSpaceOrNewParagraph(character,
100 isHitWhiteSpaceOrNewParagraph);
102 if(isHitWhiteSpaceOrNewParagraph != isWhiteSpaceOrNewParagraph)
109 void FindEndOfWord(FindWordData& data)
111 const bool isHitWhiteSpaceOrNewParagraph = data.isWhiteSpace || data.isNewParagraph;
113 for(data.foundIndex = data.hitCharacter + 1u; data.foundIndex < data.totalNumberOfCharacters; ++data.foundIndex)
115 const Dali::Toolkit::Text::Character character = *(data.textBuffer + data.foundIndex);
117 const bool isWhiteSpaceOrNewParagraph = IsWhiteSpaceOrNewParagraph(character,
119 isHitWhiteSpaceOrNewParagraph);
121 if(isHitWhiteSpaceOrNewParagraph != isWhiteSpaceOrNewParagraph)
136 LineIndex GetClosestLine(VisualModelPtr visualModel,
140 float totalHeight = 0.f;
141 LineIndex lineIndex = 0;
149 const Vector<LineRun>& lines = visualModel->mLines;
151 for(Vector<LineRun>::ConstIterator it = lines.Begin(),
156 const LineRun& lineRun = *it;
158 // The line height is the addition of the line ascender and the line descender.
159 // However, the line descender has a negative value, hence the subtraction.
160 totalHeight += lineRun.ascender - lineRun.descender;
162 if(visualY < totalHeight)
174 return lineIndex - 1u;
177 float CalculateLineOffset(const Vector<LineRun>& lines,
182 for(Vector<LineRun>::ConstIterator it = lines.Begin(),
183 endIt = lines.Begin() + lineIndex;
187 const LineRun& lineRun = *it;
189 // The line height is the addition of the line ascender and the line descender.
190 // However, the line descender has a negative value, hence the subtraction.
191 offset += lineRun.ascender - lineRun.descender;
197 CharacterIndex GetClosestCursorIndex(VisualModelPtr visualModel,
198 LogicalModelPtr logicalModel,
202 CharacterHitTest::Mode mode,
203 bool& matchedCharacter)
205 DALI_LOG_INFO(gLogFilter, Debug::Verbose, "GetClosestCursorIndex, closest visualX %f visualY %f\n", visualX, visualY);
207 // Whether there is a hit on a glyph.
208 matchedCharacter = false;
210 CharacterIndex logicalIndex = 0;
212 const Length totalNumberOfGlyphs = visualModel->mGlyphs.Count();
213 const Length totalNumberOfLines = visualModel->mLines.Count();
214 if((0 == totalNumberOfGlyphs) ||
215 (0 == totalNumberOfLines))
220 // Whether there is a hit on a line.
221 bool matchedLine = false;
223 // Find which line is closest.
224 const LineIndex lineIndex = Text::GetClosestLine(visualModel,
228 if(!matchedLine && (CharacterHitTest::TAP == mode))
230 // Return the first or the last character if the touch point doesn't hit a line.
231 return (visualY < 0.f) ? 0 : logicalModel->mText.Count();
234 // Convert from text's coords to line's coords.
235 const LineRun& line = *(visualModel->mLines.Begin() + lineIndex);
237 // Transform the tap point from text's coords to line's coords.
238 visualX -= line.alignmentOffset;
240 // Get the positions of the glyphs.
241 const Vector2* const positionsBuffer = visualModel->mGlyphPositions.Begin();
243 // Get the character to glyph conversion table.
244 const GlyphIndex* const charactersToGlyphBuffer = visualModel->mCharactersToGlyph.Begin();
246 // Get the glyphs per character table.
247 const Length* const glyphsPerCharacterBuffer = visualModel->mGlyphsPerCharacter.Begin();
249 // Get the characters per glyph table.
250 const Length* const charactersPerGlyphBuffer = visualModel->mCharactersPerGlyph.Begin();
252 // Get the glyph's info buffer.
253 const GlyphInfo* const glyphInfoBuffer = visualModel->mGlyphs.Begin();
255 const CharacterIndex startCharacter = line.characterRun.characterIndex;
256 const CharacterIndex endCharacter = line.characterRun.characterIndex + line.characterRun.numberOfCharacters;
257 DALI_ASSERT_DEBUG(endCharacter <= logicalModel->mText.Count() && "Invalid line info");
259 // Whether this line is a bidirectional line.
260 const bool bidiLineFetched = logicalModel->FetchBidirectionalLineInfo(startCharacter);
262 // The character's direction buffer.
263 const CharacterDirection* const directionsBuffer = bidiLineFetched ? logicalModel->mCharacterDirections.Begin() : NULL;
265 // Whether the touch point if before the first glyph.
266 bool isBeforeFirstGlyph = false;
268 // Traverses glyphs in visual order. To do that use the visual to logical conversion table.
269 CharacterIndex visualIndex = startCharacter;
270 Length numberOfVisualCharacters = 0;
271 for(; visualIndex < endCharacter; ++visualIndex)
273 // The character in logical order.
274 const CharacterIndex characterLogicalOrderIndex = (bidiLineFetched ? logicalModel->GetLogicalCharacterIndex(visualIndex) : visualIndex);
275 const CharacterDirection direction = (bidiLineFetched ? *(directionsBuffer + characterLogicalOrderIndex) : LTR);
277 // The number of glyphs for that character
278 const Length numberOfGlyphs = *(glyphsPerCharacterBuffer + characterLogicalOrderIndex);
279 ++numberOfVisualCharacters;
281 if(0 != numberOfGlyphs)
283 // Get the first character/glyph of the group of glyphs.
284 const CharacterIndex firstVisualCharacterIndex = 1u + visualIndex - numberOfVisualCharacters;
285 const CharacterIndex firstLogicalCharacterIndex = (bidiLineFetched ? logicalModel->GetLogicalCharacterIndex(firstVisualCharacterIndex) : firstVisualCharacterIndex);
286 const GlyphIndex firstLogicalGlyphIndex = *(charactersToGlyphBuffer + firstLogicalCharacterIndex);
288 // Get the metrics for the group of glyphs.
289 GlyphMetrics glyphMetrics;
290 GetGlyphsMetrics(firstLogicalGlyphIndex,
296 // Get the position of the first glyph.
297 const Vector2& position = *(positionsBuffer + firstLogicalGlyphIndex);
299 if(startCharacter == visualIndex)
301 const float glyphPosition = -glyphMetrics.xBearing + position.x;
303 if(visualX < glyphPosition)
305 isBeforeFirstGlyph = true;
310 // Whether the glyph can be split, like Latin ligatures fi, ff or Arabic (ل + ا).
311 Length numberOfCharacters = *(charactersPerGlyphBuffer + firstLogicalGlyphIndex);
314 // As characters are being traversed in visual order,
315 // for right to left ligatures, the character which contains the
316 // number of glyphs in the table is found first.
317 // Jump the number of characters to the next glyph is needed.
319 if(0 == numberOfCharacters)
321 // TODO: This is a workaround to fix an issue with complex characters in the arabic
322 // script like i.e. رّ or الأَبْجَدِيَّة العَرَبِيَّة
323 // There are characters that are not shaped in one glyph but in combination with
324 // the next one generates two of them.
325 // The visual to logical conversion table have characters in different order than
326 // expected even if all of them are arabic.
328 // The workaround doesn't fix the issue completely but it prevents the application
329 // to hang in an infinite loop.
331 // Find the number of characters.
332 for(GlyphIndex index = firstLogicalGlyphIndex + 1u;
333 (0 == numberOfCharacters) && (index < totalNumberOfGlyphs);
336 numberOfCharacters = *(charactersPerGlyphBuffer + index);
339 if(2u > numberOfCharacters)
344 --numberOfCharacters;
347 visualIndex += numberOfCharacters - 1u;
350 // Get the script of the character.
351 const Script script = logicalModel->GetScript(characterLogicalOrderIndex);
353 const bool isInterglyphIndex = (numberOfCharacters > numberOfGlyphs) && HasLigatureMustBreak(script);
354 const Length numberOfBlocks = isInterglyphIndex ? numberOfCharacters : 1u;
355 const float glyphAdvance = glyphMetrics.advance / static_cast<float>(numberOfBlocks);
357 CharacterIndex index = 0;
358 for(; index < numberOfBlocks; ++index)
360 // Find the mid-point of the area containing the glyph
361 const float glyphCenter = -glyphMetrics.xBearing + position.x + (static_cast<float>(index) + 0.5f) * glyphAdvance;
363 if(visualX < glyphCenter)
365 matchedCharacter = true;
372 // If the glyph is shaped from more than one character, it matches the character of the glyph.
373 visualIndex = firstVisualCharacterIndex + index;
377 numberOfVisualCharacters = 0;
379 } // for characters in visual order.
381 // The number of characters of the whole text.
382 const Length totalNumberOfCharacters = logicalModel->mText.Count();
384 // Return the logical position of the cursor in characters.
386 if(!matchedCharacter)
388 if(isBeforeFirstGlyph)
390 // If no character is matched, then the first character (in visual order) of the line is used.
391 visualIndex = startCharacter;
395 // If no character is matched, then the last character (in visual order) of the line is used.
396 visualIndex = endCharacter;
400 // Get the paragraph direction.
401 const CharacterDirection paragraphDirection = line.direction;
403 if(totalNumberOfCharacters != visualIndex)
405 // The visual index is not at the end of the text.
407 if(LTR == paragraphDirection)
409 // The paragraph direction is left to right.
411 if(visualIndex == endCharacter)
413 // It places the cursor just before the last character in visual order.
414 // i.e. it places the cursor just before the '\n' or before the last character
415 // if there is a long line with no word breaks which is wrapped.
417 // It doesn't check if the closest line is the last one like the RTL branch below
418 // because the total number of characters is different than the visual index and
419 // the visual index is the last character of the line.
425 // The paragraph direction is right to left.
427 if((lineIndex != totalNumberOfLines - 1u) && // is not the last line.
428 (visualIndex == startCharacter))
430 // It places the cursor just after the first character in visual order.
431 // i.e. it places the cursor just after the '\n' or after the last character
432 // if there is a long line with no word breaks which is wrapped.
434 // If the last line doesn't end with '\n' it won't increase the visual index
435 // placing the cursor at the beginning of the line (in visual order).
442 // The visual index is at the end of text.
444 // If the text ends with a new paragraph character i.e. a '\n', an extra line with no characters is added at the end of the text.
445 // This branch checks if the closest line is the one with the last '\n'. If it is, it decrements the visual index to place
446 // the cursor just before the last '\n'.
448 if((lineIndex != totalNumberOfLines - 1u) &&
449 TextAbstraction::IsNewParagraph(*(logicalModel->mText.Begin() + visualIndex - 1u)))
455 logicalIndex = (bidiLineFetched ? logicalModel->GetLogicalCursorIndex(visualIndex) : visualIndex);
457 DALI_LOG_INFO(gLogFilter, Debug::Verbose, "closest visualIndex %d logicalIndex %d\n", visualIndex, logicalIndex);
459 DALI_ASSERT_DEBUG((logicalIndex <= logicalModel->mText.Count() && logicalIndex >= 0) && "GetClosestCursorIndex - Out of bounds index");
464 void GetCursorPosition(GetCursorPositionParameters& parameters,
465 CursorInfo& cursorInfo)
467 const LineRun* const modelLines = parameters.visualModel->mLines.Begin();
468 if(NULL == modelLines)
474 // Whether the logical cursor position is at the end of the whole text.
475 const bool isLastPosition = parameters.logicalModel->mText.Count() == parameters.logical;
477 // Get the line where the character is laid-out.
478 const CharacterIndex characterOfLine = isLastPosition ? (parameters.logical - 1u) : parameters.logical;
480 // Whether the cursor is in the last position and the last position is a new paragraph character.
481 const bool isLastNewParagraph = parameters.isMultiline && isLastPosition && TextAbstraction::IsNewParagraph(*(parameters.logicalModel->mText.Begin() + characterOfLine));
483 const LineIndex lineIndex = parameters.visualModel->GetLineOfCharacter(characterOfLine);
484 const LineRun& line = *(modelLines + lineIndex);
486 if(isLastNewParagraph)
488 // The cursor is in a new line with no characters. Place the cursor in that line.
489 const LineIndex newLineIndex = lineIndex + 1u;
490 const LineRun& newLine = *(modelLines + newLineIndex);
492 cursorInfo.isSecondaryCursor = false;
494 // Set the line offset and height.
495 cursorInfo.lineOffset = CalculateLineOffset(parameters.visualModel->mLines,
498 // The line height is the addition of the line ascender and the line descender.
499 // However, the line descender has a negative value, hence the subtraction.
500 cursorInfo.lineHeight = newLine.ascender - newLine.descender;
502 // Set the primary cursor's height.
503 cursorInfo.primaryCursorHeight = cursorInfo.lineHeight;
505 // Set the primary cursor's position.
506 cursorInfo.primaryPosition.x = (LTR == line.direction) ? newLine.alignmentOffset : parameters.visualModel->mControlSize.width - newLine.alignmentOffset;
507 cursorInfo.primaryPosition.y = cursorInfo.lineOffset;
511 // Whether this line is a bidirectional line.
512 const bool bidiLineFetched = parameters.logicalModel->FetchBidirectionalLineInfo(characterOfLine);
514 // Check if the logical position is the first or the last one of the line.
515 const bool isFirstPositionOfLine = line.characterRun.characterIndex == parameters.logical;
516 const bool isLastPositionOfLine = line.characterRun.characterIndex + line.characterRun.numberOfCharacters == parameters.logical;
518 // 'logical' is the logical 'cursor' index.
519 // Get the next and current logical 'character' index.
520 const CharacterIndex characterIndex = isFirstPositionOfLine ? parameters.logical : parameters.logical - 1u;
521 const CharacterIndex nextCharacterIndex = isLastPositionOfLine ? characterIndex : parameters.logical;
523 // The character's direction buffer.
524 const CharacterDirection* const directionsBuffer = bidiLineFetched ? parameters.logicalModel->mCharacterDirections.Begin() : NULL;
526 CharacterDirection isCurrentRightToLeft = false;
527 CharacterDirection isNextRightToLeft = false;
528 if(bidiLineFetched) // If bidiLineFetched is false, it means the whole text is left to right.
530 isCurrentRightToLeft = *(directionsBuffer + characterIndex);
531 isNextRightToLeft = *(directionsBuffer + nextCharacterIndex);
534 // Get the paragraph's direction.
535 const CharacterDirection isRightToLeftParagraph = line.direction;
537 // Check whether there is an alternative position:
538 cursorInfo.isSecondaryCursor = ((!isLastPositionOfLine && (isCurrentRightToLeft != isNextRightToLeft)) ||
539 (isLastPositionOfLine && (isRightToLeftParagraph != isCurrentRightToLeft)) ||
540 (isFirstPositionOfLine && (isRightToLeftParagraph != isCurrentRightToLeft)));
542 // Set the line offset and height.
543 cursorInfo.lineOffset = CalculateLineOffset(parameters.visualModel->mLines,
546 // The line height is the addition of the line ascender and the line descender.
547 // However, the line descender has a negative value, hence the subtraction.
548 cursorInfo.lineHeight = line.ascender - line.descender;
550 // Calculate the primary cursor.
552 CharacterIndex index = characterIndex;
553 if(cursorInfo.isSecondaryCursor)
555 // If there is a secondary position, the primary cursor may be in a different place than the logical index.
557 if(isLastPositionOfLine)
559 // The position of the cursor after the last character needs special
560 // care depending on its direction and the direction of the paragraph.
562 // Need to find the first character after the last character with the paragraph's direction.
563 // i.e l0 l1 l2 r0 r1 should find r0.
565 index = isRightToLeftParagraph ? line.characterRun.characterIndex : line.characterRun.characterIndex + line.characterRun.numberOfCharacters - 1u;
568 index = parameters.logicalModel->GetLogicalCharacterIndex(index);
571 else if(isFirstPositionOfLine)
573 index = isRightToLeftParagraph ? line.characterRun.characterIndex + line.characterRun.numberOfCharacters - 1u : line.characterRun.characterIndex;
576 index = parameters.logicalModel->GetLogicalCharacterIndex(index);
581 index = (isRightToLeftParagraph == isCurrentRightToLeft) ? characterIndex : nextCharacterIndex;
585 const GlyphIndex* const charactersToGlyphBuffer = parameters.visualModel->mCharactersToGlyph.Begin();
586 const Length* const glyphsPerCharacterBuffer = parameters.visualModel->mGlyphsPerCharacter.Begin();
587 const Length* const charactersPerGlyphBuffer = parameters.visualModel->mCharactersPerGlyph.Begin();
588 const CharacterIndex* const glyphsToCharactersBuffer = parameters.visualModel->mGlyphsToCharacters.Begin();
589 const Vector2* const glyphPositionsBuffer = parameters.visualModel->mGlyphPositions.Begin();
590 const GlyphInfo* const glyphInfoBuffer = parameters.visualModel->mGlyphs.Begin();
592 // Convert the cursor position into the glyph position.
593 const GlyphIndex primaryGlyphIndex = *(charactersToGlyphBuffer + index);
594 const Length primaryNumberOfGlyphs = *(glyphsPerCharacterBuffer + index);
595 const Length primaryNumberOfCharacters = *(charactersPerGlyphBuffer + primaryGlyphIndex);
597 // Get the metrics for the group of glyphs.
598 GlyphMetrics glyphMetrics;
599 GetGlyphsMetrics(primaryGlyphIndex,
600 primaryNumberOfGlyphs,
605 // Whether to add the glyph's advance to the cursor position.
606 // i.e if the paragraph is left to right and the logical cursor is zero, the position is the position of the first glyph and the advance is not added,
607 // if the logical cursor is one, the position is the position of the first glyph and the advance is added.
608 // A 'truth table' was build and an online Karnaugh map tool was used to simplify the logic.
629 // Where F -> isFirstPosition
630 // L -> isLastPosition
631 // C -> isCurrentRightToLeft
632 // P -> isRightToLeftParagraph
633 // A -> Whether to add the glyph's advance.
635 const bool addGlyphAdvance = ((isLastPositionOfLine && !isRightToLeftParagraph) ||
636 (isFirstPositionOfLine && isRightToLeftParagraph) ||
637 (!isFirstPositionOfLine && !isLastPosition && !isCurrentRightToLeft));
639 float glyphAdvance = addGlyphAdvance ? glyphMetrics.advance : 0.f;
641 if(!isLastPositionOfLine &&
642 (primaryNumberOfCharacters > 1u))
644 const CharacterIndex firstIndex = *(glyphsToCharactersBuffer + primaryGlyphIndex);
646 bool isCurrentRightToLeft = false;
647 if(bidiLineFetched) // If bidiLineFetched is false, it means the whole text is left to right.
649 isCurrentRightToLeft = *(directionsBuffer + index);
652 Length numberOfGlyphAdvance = (isFirstPositionOfLine ? 0 : 1u) + characterIndex - firstIndex;
653 if(isCurrentRightToLeft)
655 numberOfGlyphAdvance = primaryNumberOfCharacters - numberOfGlyphAdvance;
658 glyphAdvance = static_cast<float>(numberOfGlyphAdvance) * glyphMetrics.advance / static_cast<float>(primaryNumberOfCharacters);
661 // Get the glyph position and x bearing (in the line's coords).
662 const Vector2& primaryPosition = *(glyphPositionsBuffer + primaryGlyphIndex);
664 // Set the primary cursor's height.
665 cursorInfo.primaryCursorHeight = cursorInfo.isSecondaryCursor ? 0.5f * glyphMetrics.fontHeight : glyphMetrics.fontHeight;
667 cursorInfo.glyphOffset = line.ascender - glyphMetrics.ascender;
668 // Set the primary cursor's position.
669 cursorInfo.primaryPosition.x = -glyphMetrics.xBearing + primaryPosition.x + glyphAdvance;
670 cursorInfo.primaryPosition.y = cursorInfo.lineOffset + cursorInfo.glyphOffset;
672 // Transform the cursor info from line's coords to text's coords.
673 cursorInfo.primaryPosition.x += line.alignmentOffset;
675 // Calculate the secondary cursor.
676 if(cursorInfo.isSecondaryCursor)
678 // Set the secondary cursor's height.
679 cursorInfo.secondaryCursorHeight = 0.5f * glyphMetrics.fontHeight;
681 CharacterIndex index = characterIndex;
682 if(!isLastPositionOfLine)
684 index = (isRightToLeftParagraph == isCurrentRightToLeft) ? nextCharacterIndex : characterIndex;
687 const GlyphIndex secondaryGlyphIndex = *(charactersToGlyphBuffer + index);
688 const Length secondaryNumberOfGlyphs = *(glyphsPerCharacterBuffer + index);
690 const Vector2& secondaryPosition = *(glyphPositionsBuffer + secondaryGlyphIndex);
692 GetGlyphsMetrics(secondaryGlyphIndex,
693 secondaryNumberOfGlyphs,
698 // Set the secondary cursor's position.
711 // Where F -> isFirstPosition
712 // C -> isCurrentRightToLeft
713 // P -> isRightToLeftParagraph
714 // A -> Whether to add the glyph's advance.
716 const bool addGlyphAdvance = ((!isFirstPositionOfLine && !isCurrentRightToLeft) ||
717 (isFirstPositionOfLine && !isRightToLeftParagraph));
719 cursorInfo.secondaryPosition.x = -glyphMetrics.xBearing + secondaryPosition.x + (addGlyphAdvance ? glyphMetrics.advance : 0.f);
720 cursorInfo.secondaryPosition.y = cursorInfo.lineOffset + cursorInfo.lineHeight - cursorInfo.secondaryCursorHeight;
722 // Transform the cursor info from line's coords to text's coords.
723 cursorInfo.secondaryPosition.x += line.alignmentOffset;
728 bool FindSelectionIndices(VisualModelPtr visualModel,
729 LogicalModelPtr logicalModel,
733 CharacterIndex& startIndex,
734 CharacterIndex& endIndex,
735 CharacterIndex& noTextHitIndex)
739 |-------------------------------------------------------|------------------------------------------|
740 | On a word | The word |
741 | On a single white space between words | The word before or after the white space |
742 | On one of the multiple contiguous white spaces | The white spaces |
743 | On a single white space which is in the position zero | The white space and the next word |
744 | On a new paragraph character | The word or group of white spaces before |
745 |-------------------------------------------------------|------------------------------------------|
747 const Length totalNumberOfCharacters = logicalModel->mText.Count();
752 if(0 == totalNumberOfCharacters)
754 // Nothing to do if the model is empty.
758 bool matchedCharacter = false;
759 CharacterIndex hitCharacter = Text::GetClosestCursorIndex(visualModel,
764 CharacterHitTest::TAP,
767 if(!matchedCharacter)
769 noTextHitIndex = hitCharacter;
772 DALI_ASSERT_DEBUG((hitCharacter <= totalNumberOfCharacters) && "GetClosestCursorIndex returned out of bounds index");
774 if(hitCharacter >= totalNumberOfCharacters)
776 // Closest hit character is the last character.
777 if(hitCharacter == totalNumberOfCharacters)
779 hitCharacter--; //Hit character index set to last character in logical model
783 // hitCharacter is out of bounds
788 const Character* const textBuffer = logicalModel->mText.Begin();
790 startIndex = hitCharacter;
791 endIndex = hitCharacter;
793 // Whether the hit character is a new paragraph character.
794 const bool isHitCharacterNewParagraph = TextAbstraction::IsNewParagraph(*(textBuffer + hitCharacter));
796 // Whether the hit character is a white space. Note a new paragraph character is a white space as well but here is not wanted.
797 const bool isHitCharacterWhiteSpace = TextAbstraction::IsWhiteSpace(*(textBuffer + hitCharacter)) && !isHitCharacterNewParagraph;
799 FindWordData data(textBuffer,
800 totalNumberOfCharacters,
802 isHitCharacterWhiteSpace,
803 isHitCharacterNewParagraph);
805 if(isHitCharacterNewParagraph)
807 // Find the first character before the hit one which is not a new paragraph character.
811 endIndex = hitCharacter - 1u;
812 for(; endIndex > 0; --endIndex)
814 const Dali::Toolkit::Text::Character character = *(data.textBuffer + endIndex);
816 if(!Dali::TextAbstraction::IsNewParagraph(character))
823 data.hitCharacter = endIndex;
824 data.isNewParagraph = false;
825 data.isWhiteSpace = TextAbstraction::IsWhiteSpace(*(textBuffer + data.hitCharacter));
828 // Find the start of the word.
829 FindStartOfWord(data);
830 startIndex = data.foundIndex;
832 // Find the end of the word.
834 endIndex = data.foundIndex;
836 if(1u == (endIndex - startIndex))
838 if(isHitCharacterWhiteSpace)
840 // Select the word before or after the white space
842 if(0 == hitCharacter)
844 data.isWhiteSpace = false;
846 endIndex = data.foundIndex;
848 else if(hitCharacter > 0)
850 // Find the start of the word.
851 data.hitCharacter = hitCharacter - 1u;
852 data.isWhiteSpace = false;
853 FindStartOfWord(data);
854 startIndex = data.foundIndex;
861 return matchedCharacter;
866 } // namespace Toolkit