1 #ifndef __DALI_TOOLKIT_TEXT_CURSOR_HELPER_FUNCTIONS_H__
2 #define __DALI_TOOLKIT_TEXT_CURSOR_HELPER_FUNCTIONS_H__
5 * Copyright (c) 2016 Samsung Electronics Co., Ltd.
7 * Licensed under the Apache License, Version 2.0 (the "License");
8 * you may not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
11 * http://www.apache.org/licenses/LICENSE-2.0
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS,
15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
22 #include <dali-toolkit/internal/text/logical-model-impl.h>
23 #include <dali-toolkit/internal/text/metrics.h>
24 #include <dali-toolkit/internal/text/visual-model-impl.h>
42 primaryCursorHeight( 0.f ),
43 secondaryCursorHeight( 0.f ),
44 isSecondaryCursor( false )
50 Vector2 primaryPosition; ///< The primary cursor's position (in text's coords).
51 Vector2 secondaryPosition; ///< The secondary cursor's position (in text's coords).
52 float lineOffset; ///< The vertical offset where the line containing the cursor starts.
53 float lineHeight; ///< The height of the line where the cursor is placed.
54 float primaryCursorHeight; ///< The primary cursor's height.
55 float secondaryCursorHeight; ///< The secondary cursor's height.
56 bool isSecondaryCursor; ///< Whether the secondary cursor is valid.
60 * @brief Retrieves the closest line for a given touch point.
62 * It returns the first line if the touch point is above the text and the last line if the touch point is below.
64 * @param[in] visualModel The visual model.
65 * @param[in] visualY The touch point 'y' in text's coords.
67 * @return A line index.
69 LineIndex GetClosestLine( VisualModelPtr visualModel,
73 * @brief Retrieves the cursor's logical position for a given touch point x,y
75 * @param[in] visualModel The visual model.
76 * @param[in] logicalModel The logical model.
77 * @param[in] metrics A wrapper around FontClient used to get metrics.
78 * @param[in] visualX The touch point 'x' in text's coords.
79 * @param[in] visualY The touch point 'y' in text's coords.
81 * @return The logical cursor position (in characters). 0 is just before the first character, a value equal to the number of characters is just after the last character.
83 CharacterIndex GetClosestCursorIndex( VisualModelPtr visualModel,
84 LogicalModelPtr logicalModel,
91 * @brief Calculates the cursor's position for a given character index in the logical order.
93 * It retrieves as well the line's height and the cursor's height and
94 * if there is a valid alternative cursor, its position and height.
96 * @param[in] visualModel The visual model.
97 * @param[in] logicalModel The logical model.
98 * @param[in] metrics A wrapper around FontClient used to get metrics.
99 * @param[in] logical The logical cursor position (in characters). 0 is just before the first character, a value equal to the number of characters is just after the last character.
100 * @param[out] cursorInfo The line's height, the cursor's height, the cursor's position and whether there is an alternative cursor.
102 void GetCursorPosition( VisualModelPtr visualModel,
103 LogicalModelPtr logicalModel,
105 CharacterIndex logical,
106 CursorInfo& cursorInfo );
109 * @brief Find the indices to the first and last characters of a word for the given touch point.
111 * @param[in] visualModel The visual model.
112 * @param[in] logicalModel The logical model.
113 * @param[in] metrics A wrapper around FontClient used to get metrics.
114 * @param[in] visualX The touch point 'x' in text's coords.
115 * @param[in] visualY The touch point 'y' in text's coords.
116 * @param[out] startIndex Index to the first character of the selected word.
117 * @param[out] endIndex Index to the last character of the selected word.
119 void FindSelectionIndices( VisualModelPtr visualModel,
120 LogicalModelPtr logicalModel,
124 CharacterIndex& startIndex,
125 CharacterIndex& endIndex );
129 } // namespace Toolkit
133 #endif // __DALI_TOOLKIT_TEXT_CURSOR_HELPER_FUNCTIONS_H__