/* * This source file is part of RmlUi, the HTML/CSS Interface Middleware * * For the latest information, see http://github.com/mikke89/RmlUi * * Copyright (c) 2008-2010 CodePoint Ltd, Shift Technology Ltd * Copyright (c) 2019 The RmlUi Team, and contributors * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. * */ #include "precompiled.h" #include "ElementTextDefault.h" #include "ElementDefinition.h" #include "ElementStyle.h" #include "FontFaceHandleDefault.h" #include "../../Include/RmlUi/Core/ElementDocument.h" #include "../../Include/RmlUi/Core/ElementUtilities.h" #include "../../Include/RmlUi/Core/Event.h" #include "../../Include/RmlUi/Core/Property.h" namespace Rml { namespace Core { static bool BuildToken(String& token, const char*& token_begin, const char* string_end, bool first_token, bool collapse_white_space, bool break_at_endline, Style::TextTransform text_transformation); static bool LastToken(const char* token_begin, const char* string_end, bool collapse_white_space, bool break_at_endline); ElementTextDefault::ElementTextDefault(const String& tag) : ElementText(tag), colour(255, 255, 255), decoration(this) { dirty_layout_on_change = true; generated_decoration = Style::TextDecoration::None; decoration_property = Style::TextDecoration::None; geometry_dirty = true; font_configuration = -1; font_dirty = true; font_handle_version = 0; } ElementTextDefault::~ElementTextDefault() { } void ElementTextDefault::SetText(const String& _text) { if (text != _text) { text = _text; if (dirty_layout_on_change) DirtyLayout(); } } const String& ElementTextDefault::GetText() const { return text; } void ElementTextDefault::OnRender() { RMLUI_ZoneScoped; FontFaceHandle font_face_handle = GetFontFaceHandle(); if (font_face_handle == 0) return; // If our font configuration has potentially changed, update it and force a geometry // generation if necessary. if (font_dirty && UpdateFontConfiguration()) geometry_dirty = true; // Dirty geometry if font version has changed int new_version = GetFontEngineInterface()->GetVersion(font_face_handle); if (new_version != font_handle_version) { font_handle_version = new_version; geometry_dirty = true; } // Regenerate the geometry if the colour or font configuration has altered. if (geometry_dirty) GenerateGeometry(font_face_handle); Vector2f translation = GetAbsoluteOffset(); bool render = true; Vector2i clip_origin; Vector2i clip_dimensions; if (GetContext()->GetActiveClipRegion(clip_origin, clip_dimensions)) { float clip_top = (float)clip_origin.y; float clip_left = (float)clip_origin.x; float clip_right = (float)(clip_origin.x + clip_dimensions.x); float clip_bottom = (float)(clip_origin.y + clip_dimensions.y); float line_height = (float)GetFontEngineInterface()->GetLineHeight(GetFontFaceHandle()); render = false; for (size_t i = 0; i < lines.size(); ++i) { const Line& line = lines[i]; float x = translation.x + line.position.x; float y = translation.y + line.position.y; bool render_line = !(x > clip_right); render_line = render_line && !(x + line.width < clip_left); render_line = render_line && !(y - line_height > clip_bottom); render_line = render_line && !(y < clip_top); if (render_line) { render = true; break; } } } translation = translation.Round(); if (render) { for (size_t i = 0; i < geometry.size(); ++i) geometry[i].Render(translation); } if (decoration_property != Style::TextDecoration::None) decoration.Render(translation); } // Generates a token of text from this element, returning only the width. bool ElementTextDefault::GenerateToken(float& token_width, int line_begin) { RMLUI_ZoneScoped; // Bail if we don't have a valid font face. FontFaceHandle font_face_handle = GetFontFaceHandle(); if (font_face_handle == 0 || line_begin >= (int) text.size()) return 0; // Determine how we are processing white-space while formatting the text. using namespace Style; auto& computed = GetComputedValues(); WhiteSpace white_space_property = computed.white_space; bool collapse_white_space = white_space_property == WhiteSpace::Normal || white_space_property == WhiteSpace::Nowrap || white_space_property == WhiteSpace::Preline; bool break_at_endline = white_space_property == WhiteSpace::Pre || white_space_property == WhiteSpace::Prewrap || white_space_property == WhiteSpace::Preline; const char* token_begin = text.c_str() + line_begin; String token; BuildToken(token, token_begin, text.c_str() + text.size(), true, collapse_white_space, break_at_endline, computed.text_transform); token_width = (float) GetFontEngineInterface()->GetStringWidth(font_face_handle, token); return LastToken(token_begin, text.c_str() + text.size(), collapse_white_space, break_at_endline); } // Generates a line of text rendered from this element bool ElementTextDefault::GenerateLine(String& line, int& line_length, float& line_width, int line_begin, float maximum_line_width, float right_spacing_width, bool trim_whitespace_prefix) { RMLUI_ZoneScoped; FontFaceHandle font_face_handle = GetFontFaceHandle(); // Initialise the output variables. line.clear(); line_length = 0; line_width = 0; // Bail if we don't have a valid font face. if (font_face_handle == 0) return true; // Determine how we are processing white-space while formatting the text. using namespace Style; auto& computed = GetComputedValues(); WhiteSpace white_space_property = computed.white_space; bool collapse_white_space = white_space_property == WhiteSpace::Normal || white_space_property == WhiteSpace::Nowrap || white_space_property == WhiteSpace::Preline; bool break_at_line = maximum_line_width >= 0 && (white_space_property == WhiteSpace::Normal || white_space_property == WhiteSpace::Prewrap || white_space_property == WhiteSpace::Preline); bool break_at_endline = white_space_property == WhiteSpace::Pre || white_space_property == WhiteSpace::Prewrap || white_space_property == WhiteSpace::Preline; // Determine what (if any) text transformation we are putting the characters through. TextTransform text_transform_property = computed.text_transform; // Starting at the line_begin character, we generate sections of the text (we'll call them tokens) depending on the // white-space parsing parameters. Each section is then appended to the line if it can fit. If not, or if an // endline is found (and we're processing them), then the line is ended. kthxbai! const char* token_begin = text.c_str() + line_begin; const char* string_end = text.c_str() + text.size(); while (token_begin != string_end) { String token; const char* next_token_begin = token_begin; CodePoint previous_codepoint = CodePoint::Null; if (!line.empty()) previous_codepoint = StringUtilities::ToCodePoint(StringUtilities::SeekBackwardUTF8(&line.back(), line.data())); // Generate the next token and determine its pixel-length. bool break_line = BuildToken(token, next_token_begin, string_end, line.empty() && trim_whitespace_prefix, collapse_white_space, break_at_endline, text_transform_property); int token_width = GetFontEngineInterface()->GetStringWidth(font_face_handle, token, previous_codepoint); // If we're breaking to fit a line box, check if the token can fit on the line before we add it. if (break_at_line) { if (!line.empty() && (line_width + token_width > maximum_line_width || (LastToken(next_token_begin, string_end, collapse_white_space, break_at_endline) && line_width + token_width > maximum_line_width - right_spacing_width))) { return false; } } // The token can fit on the end of the line, so add it onto the end and increment our width and length // counters. line += token; line_length += (int)(next_token_begin - token_begin); line_width += token_width; // Break out of the loop if an endline was forced. if (break_line) return false; // Set the beginning of the next token. token_begin = next_token_begin; } return true; } // Clears all lines of generated text and prepares the element for generating new lines. void ElementTextDefault::ClearLines() { // Clear the rendering information. for (size_t i = 0; i < geometry.size(); ++i) geometry[i].Release(true); lines.clear(); decoration.Release(true); } // Adds a new line into the text element. void ElementTextDefault::AddLine(const Vector2f& line_position, const String& line) { FontFaceHandle font_face_handle = GetFontFaceHandle(); if (font_face_handle == 0) return; if (font_dirty) UpdateFontConfiguration(); Vector2f baseline_position = line_position + Vector2f(0.0f, (float)GetFontEngineInterface()->GetLineHeight(font_face_handle) - GetFontEngineInterface()->GetBaseline(font_face_handle)); lines.push_back(Line(line, baseline_position)); geometry_dirty = true; } // Prevents the element from dirtying its document's layout when its text is changed. void ElementTextDefault::SuppressAutoLayout() { dirty_layout_on_change = false; } void ElementTextDefault::OnPropertyChange(const PropertyIdSet& changed_properties) { RMLUI_ZoneScoped; Element::OnPropertyChange(changed_properties); bool colour_changed = false; bool font_face_changed = false; auto& computed = GetComputedValues(); if (changed_properties.Contains(PropertyId::Color) || changed_properties.Contains(PropertyId::Opacity)) { // Fetch our (potentially) new colour. Colourb new_colour = computed.color; float opacity = computed.opacity; new_colour.alpha = byte(opacity * float(new_colour.alpha)); colour_changed = colour != new_colour; if (colour_changed) colour = new_colour; } if (changed_properties.Contains(PropertyId::FontFamily) || changed_properties.Contains(PropertyId::FontWeight) || changed_properties.Contains(PropertyId::FontStyle) || changed_properties.Contains(PropertyId::FontSize)) { font_face_changed = true; geometry.clear(); font_dirty = true; } if (changed_properties.Contains(PropertyId::TextDecoration)) { decoration_property = computed.text_decoration; if (decoration_property != Style::TextDecoration::None) { if (decoration_property != generated_decoration) { decoration.Release(true); FontFaceHandle font_face_handle = GetFontFaceHandle(); if (font_face_handle != 0) { for (size_t i = 0; i < lines.size(); ++i) GenerateDecoration(font_face_handle, lines[i]); } generated_decoration = decoration_property; } } } if (font_face_changed) { // We have to let our document know we need to be regenerated. if (dirty_layout_on_change) DirtyLayout(); } else if (colour_changed) { // Force the geometry to be regenerated. geometry_dirty = true; // Re-colour the decoration geometry. std::vector< Vertex >& vertices = decoration.GetVertices(); for (size_t i = 0; i < vertices.size(); ++i) vertices[i].colour = colour; decoration.Release(); } } // Returns the RML of this element void ElementTextDefault::GetRML(String& content) { content += text; } // Updates the configuration this element uses for its font. bool ElementTextDefault::UpdateFontConfiguration() { RMLUI_ZoneScoped; if (GetFontFaceHandle() == 0) return false; font_dirty = false; static const FontEffectList empty_font_effects; // Fetch the font-effect for this text element const FontEffectList* font_effects = &empty_font_effects; if (const FontEffects* effects = GetComputedValues().font_effect.get()) font_effects = &effects->list; // Request a font layer configuration to match this set of effects. If this is different from // our old configuration, then return true to indicate we'll need to regenerate geometry. int new_configuration = GetFontEngineInterface()->GenerateLayerConfiguration(GetFontFaceHandle(), *font_effects); if (new_configuration != font_configuration) { font_configuration = new_configuration; return true; } return false; } // Clears and regenerates all of the text's geometry. void ElementTextDefault::GenerateGeometry(const FontFaceHandle font_face_handle) { RMLUI_ZoneScopedC(0xD2691E); // Release the old geometry ... for (size_t i = 0; i < geometry.size(); ++i) geometry[i].Release(true); // ... and generate it all again! for (size_t i = 0; i < lines.size(); ++i) GenerateGeometry(font_face_handle, lines[i]); geometry_dirty = false; } void ElementTextDefault::GenerateGeometry(const FontFaceHandle font_face_handle, Line& line) { line.width = GetFontEngineInterface()->GenerateString(font_face_handle, geometry, line.text, line.position, colour, font_configuration); for (size_t i = 0; i < geometry.size(); ++i) geometry[i].SetHostElement(this); if (decoration_property != Style::TextDecoration::None) GenerateDecoration(font_face_handle, line); } // Generates any geometry necessary for rendering a line decoration (underline, strike-through, etc). void ElementTextDefault::GenerateDecoration(const FontFaceHandle font_face_handle, const Line& line) { RMLUI_ZoneScopedC(0xA52A2A); GeometryUtilities::GenerateLine(font_face_handle, &decoration, line.position, line.width, decoration_property, colour); } static bool BuildToken(String& token, const char*& token_begin, const char* string_end, bool first_token, bool collapse_white_space, bool break_at_endline, Style::TextTransform text_transformation) { RMLUI_ASSERT(token_begin != string_end); token.reserve(string_end - token_begin + token.size()); // Check what the first character of the token is; all we need to know is if it is white-space or not. bool parsing_white_space = StringUtilities::IsWhitespace(*token_begin); // Loop through the string from the token's beginning until we find an end to the token. This can occur in various // places, depending on the white-space processing; // - at the end of a section of non-white-space characters, // - at the end of a section of white-space characters, if we're not collapsing white-space, // - at an endline token, if we're breaking on endlines. while (token_begin != string_end) { bool force_non_whitespace = false; char character = *token_begin; const char* escape_begin = token_begin; // Check for an ampersand; if we find one, we've got an HTML escaped character. if (character == '&') { // Find the terminating ';'. while (token_begin != string_end && *token_begin != ';') ++token_begin; // If we couldn't find the ';', print the token like normal text. if (token_begin == string_end) { token_begin = escape_begin; } // We could find a ';', parse the escape code. If the escape code is recognised, set the parsed character // to the appropriate one. If it is a non-breaking space, prevent it being picked up as whitespace. If it // is not recognised, print the token like normal text. else { String escape_code(escape_begin + 1, token_begin); if (escape_code == "lt") character = '<'; else if (escape_code == "gt") character = '>'; else if (escape_code == "amp") character = '&'; else if (escape_code == "quot") character = '"'; else if (escape_code == "nbsp") { character = ' '; force_non_whitespace = true; } else token_begin = escape_begin; } } // Check for an endline token; if we're breaking on endlines and we find one, then return true to indicate a // forced break. if (break_at_endline && character == '\n') { token += '\n'; token_begin++; return true; } // If we've transitioned from white-space characters to non-white-space characters, or vice-versa, then check // if should terminate the token; if we're not collapsing white-space, then yes (as sections of white-space are // non-breaking), otherwise only if we've transitioned from characters to white-space. bool white_space = !force_non_whitespace && StringUtilities::IsWhitespace(character); if (white_space != parsing_white_space) { if (!collapse_white_space) { // Restore pointer to the beginning of the escaped token, if we processed an escape code. token_begin = escape_begin; return false; } // We're collapsing white-space; we only tokenise words, not white-space, so we're only done tokenising // once we've begun parsing non-white-space and then found white-space. if (!parsing_white_space) { // However, if we are the last non-whitespace character in the string, and there are trailing // whitespace characters after this token, then we need to append a single space to the end of this // token. if (token_begin != string_end && LastToken(token_begin, string_end, collapse_white_space, break_at_endline)) token += ' '; return false; } // We've transitioned from white-space to non-white-space, so we append a single white-space character. if (!first_token) token += ' '; parsing_white_space = false; } // If the current character is white-space, we'll append a space character to the token if we're not collapsing // sections of white-space. if (white_space) { if (!collapse_white_space) token += ' '; } else { if (text_transformation == Style::TextTransform::Uppercase) { if (character >= 'a' && character <= 'z') character += ('A' - 'a'); } else if (text_transformation == Style::TextTransform::Lowercase) { if (character >= 'A' && character <= 'Z') character -= ('A' - 'a'); } token += character; } ++token_begin; } return false; } static bool LastToken(const char* token_begin, const char* string_end, bool collapse_white_space, bool break_at_endline) { bool last_token = (token_begin == string_end); if (collapse_white_space && !last_token) { last_token = true; const char* character = token_begin; while (character != string_end) { if (!StringUtilities::IsWhitespace(*character) || (break_at_endline && *character == '\n')) { last_token = false; break; } character++; } } return last_token; } } }