/* This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ //! Text layout. #![deny(unsafe_code)] use fragment::{Fragment, SpecificFragmentInfo, ScannedTextFragmentInfo, UnscannedTextFragmentInfo}; use inline::InlineFragments; use gfx::font::{DISABLE_KERNING_SHAPING_FLAG, FontMetrics, IGNORE_LIGATURES_SHAPING_FLAG}; use gfx::font::{RunMetrics, ShapingFlags, ShapingOptions}; use gfx::font_context::FontContext; use gfx::text::glyph::CharIndex; use gfx::text::text_run::TextRun; use gfx::text::util::{self, CompressionMode}; use std::borrow::ToOwned; use std::collections::LinkedList; use std::mem; use std::sync::Arc; use style::computed_values::{line_height, text_orientation, text_rendering, text_transform}; use style::computed_values::{white_space}; use style::properties::ComputedValues; use style::properties::style_structs::Font as FontStyle; use util::geometry::Au; use util::linked_list::split_off_head; use util::logical_geometry::{LogicalSize, WritingMode}; use util::range::{Range, RangeIndex}; /// A stack-allocated object for scanning an inline flow into `TextRun`-containing `TextFragment`s. pub struct TextRunScanner { pub clump: LinkedList, } impl TextRunScanner { pub fn new() -> TextRunScanner { TextRunScanner { clump: LinkedList::new(), } } pub fn scan_for_runs(&mut self, font_context: &mut FontContext, mut fragments: LinkedList) -> InlineFragments { debug!("TextRunScanner: scanning {} fragments for text runs...", fragments.len()); // FIXME(pcwalton): We want to be sure not to allocate multiple times, since this is a // performance-critical spot, but this may overestimate and allocate too much memory. let mut new_fragments = Vec::with_capacity(fragments.len()); let mut last_whitespace = true; while !fragments.is_empty() { // Create a clump. split_first_fragment_at_newline_if_necessary(&mut fragments); self.clump.append(&mut split_off_head(&mut fragments)); while !fragments.is_empty() && self.clump .back() .unwrap() .can_merge_with_fragment(fragments.front() .unwrap()) { split_first_fragment_at_newline_if_necessary(&mut fragments); self.clump.append(&mut split_off_head(&mut fragments)); } // Flush that clump to the list of fragments we're building up. last_whitespace = self.flush_clump_to_list(font_context, &mut new_fragments, last_whitespace); } debug!("TextRunScanner: complete."); InlineFragments { fragments: new_fragments, } } /// A "clump" is a range of inline flow leaves that can be merged together into a single /// fragment. Adjacent text with the same style can be merged, and nothing else can. /// /// The flow keeps track of the fragments contained by all non-leaf DOM nodes. This is necessary /// for correct painting order. Since we compress several leaf fragments here, the mapping must /// be adjusted. fn flush_clump_to_list(&mut self, font_context: &mut FontContext, out_fragments: &mut Vec, mut last_whitespace: bool) -> bool { debug!("TextRunScanner: flushing {} fragments in range", self.clump.len()); debug_assert!(!self.clump.is_empty()); match self.clump.front().unwrap().specific { SpecificFragmentInfo::UnscannedText(_) => {} _ => { debug_assert!(self.clump.len() == 1, "WAT: can't coalesce non-text nodes in flush_clump_to_list()!"); out_fragments.push(self.clump.pop_front().unwrap()); return last_whitespace } } // Concatenate all of the transformed strings together, saving the new character indices. let mut mappings: Vec = Vec::new(); let runs = { let fontgroup; let compression; let text_transform; let letter_spacing; let word_spacing; let text_rendering; { let in_fragment = self.clump.front().unwrap(); let font_style = in_fragment.style().get_font_arc(); let inherited_text_style = in_fragment.style().get_inheritedtext(); fontgroup = font_context.get_layout_font_group_for_style(font_style); compression = match in_fragment.white_space() { white_space::T::normal | white_space::T::nowrap => { CompressionMode::CompressWhitespaceNewline } white_space::T::pre => CompressionMode::CompressNone, }; text_transform = inherited_text_style.text_transform; letter_spacing = inherited_text_style.letter_spacing; word_spacing = inherited_text_style.word_spacing.unwrap_or(Au(0)); text_rendering = inherited_text_style.text_rendering; } // First, transform/compress text of all the nodes. let (mut run_info_list, mut run_info) = (Vec::new(), RunInfo::new()); for (fragment_index, in_fragment) in self.clump.iter().enumerate() { let mut mapping = RunMapping::new(&run_info_list[..], &run_info, fragment_index); let text = match in_fragment.specific { SpecificFragmentInfo::UnscannedText(ref text_fragment_info) => { &text_fragment_info.text } _ => panic!("Expected an unscanned text fragment!"), }; let (mut start_position, mut end_position) = (0, 0); for character in text.chars() { // Search for the first font in this font group that contains a glyph for this // character. for font_index in 0..fontgroup.fonts.len() { if font_index < fontgroup.fonts.len() - 1 && fontgroup.fonts .get(font_index) .unwrap() .borrow() .glyph_index(character) .is_none() { continue } // We found the font we want to use. Now, if necessary, flush the mapping // we were building up. if run_info.font_index != font_index { if run_info.text.len() > 0 { mapping.flush(&mut mappings, &mut run_info, &**text, compression, text_transform, &mut last_whitespace, &mut start_position, end_position); run_info_list.push(run_info); run_info = RunInfo::new(); mapping = RunMapping::new(&run_info_list[..], &run_info, fragment_index); } run_info.font_index = font_index } // Consume this character. end_position += character.len_utf8(); break } } // If the mapping is zero-length, don't flush it. if start_position == end_position { continue } // Flush the last mapping we created for this fragment to the list. mapping.flush(&mut mappings, &mut run_info, &**text, compression, text_transform, &mut last_whitespace, &mut start_position, end_position); } // Push the final run info. run_info_list.push(run_info); // Per CSS 2.1 § 16.4, "when the resultant space between two characters is not the same // as the default space, user agents should not use ligatures." This ensures that, for // example, `finally` with a wide `letter-spacing` renders as `f i n a l l y` and not // `fi n a l l y`. let mut flags = ShapingFlags::empty(); match letter_spacing { Some(Au(0)) | None => {} Some(_) => flags.insert(IGNORE_LIGATURES_SHAPING_FLAG), } if text_rendering == text_rendering::T::optimizespeed { flags.insert(IGNORE_LIGATURES_SHAPING_FLAG); flags.insert(DISABLE_KERNING_SHAPING_FLAG) } let options = ShapingOptions { letter_spacing: letter_spacing, word_spacing: word_spacing, flags: flags, }; // FIXME(https://github.com/rust-lang/rust/issues/23338) run_info_list.into_iter().map(|run_info| { let mut font = fontgroup.fonts.get(run_info.font_index).unwrap().borrow_mut(); Arc::new(box TextRun::new(&mut *font, run_info.text, &options)) }).collect::>() }; // Make new fragments with the runs and adjusted text indices. debug!("TextRunScanner: pushing {} fragment(s)", self.clump.len()); let mut mappings = mappings.into_iter().peekable(); for (logical_offset, old_fragment) in mem::replace(&mut self.clump, LinkedList::new()).into_iter().enumerate() { loop { match mappings.peek() { Some(mapping) if mapping.old_fragment_index == logical_offset => {} Some(_) | None => break, }; let mut mapping = mappings.next().unwrap(); let run = runs[mapping.text_run_index].clone(); let requires_line_break_afterward_if_wrapping_on_newlines = run.text.char_at_reverse(mapping.range.end().get() as usize) == '\n'; if requires_line_break_afterward_if_wrapping_on_newlines { mapping.range.extend_by(CharIndex(-1)) } let text_size = old_fragment.border_box.size; let mut new_text_fragment_info = box ScannedTextFragmentInfo::new( run, mapping.range, text_size, requires_line_break_afterward_if_wrapping_on_newlines); let new_metrics = new_text_fragment_info.run.metrics_for_range(&mapping.range); let writing_mode = old_fragment.style.writing_mode; let bounding_box_size = bounding_box_for_run_metrics(&new_metrics, writing_mode); new_text_fragment_info.content_size = bounding_box_size; let new_fragment = old_fragment.transform( bounding_box_size, SpecificFragmentInfo::ScannedText(new_text_fragment_info)); out_fragments.push(new_fragment) } } last_whitespace } } #[inline] fn bounding_box_for_run_metrics(metrics: &RunMetrics, writing_mode: WritingMode) -> LogicalSize { // This does nothing, but it will fail to build // when more values are added to the `text-orientation` CSS property. // This will be a reminder to update the code below. let dummy: Option = None; match dummy { Some(text_orientation::T::sideways_right) | Some(text_orientation::T::sideways_left) | Some(text_orientation::T::sideways) | None => {} } // In vertical sideways or horizontal upright text, // the "width" of text metrics is always inline // This will need to be updated when other text orientations are supported. LogicalSize::new( writing_mode, metrics.bounding_box.size.width, metrics.bounding_box.size.height) } /// Returns the metrics of the font represented by the given `FontStyle`, respectively. /// /// `#[inline]` because often the caller only needs a few fields from the font metrics. #[inline] pub fn font_metrics_for_style(font_context: &mut FontContext, font_style: Arc) -> FontMetrics { let fontgroup = font_context.get_layout_font_group_for_style(font_style); // FIXME(https://github.com/rust-lang/rust/issues/23338) let font = fontgroup.fonts[0].borrow(); font.metrics.clone() } /// Returns the line block-size needed by the given computed style and font size. pub fn line_height_from_style(style: &ComputedValues, metrics: &FontMetrics) -> Au { let font_size = style.get_font().font_size; match style.get_inheritedbox().line_height { line_height::T::Normal => metrics.line_gap, line_height::T::Number(l) => font_size.scale_by(l), line_height::T::Length(l) => l } } fn split_first_fragment_at_newline_if_necessary(fragments: &mut LinkedList) { if fragments.len() < 1 { return } let new_fragment = { let mut first_fragment = fragments.front_mut().unwrap(); let string_before; { let unscanned_text_fragment_info = match first_fragment.specific { SpecificFragmentInfo::UnscannedText(ref mut unscanned_text_fragment_info) => { unscanned_text_fragment_info } _ => return, }; if first_fragment.style.get_inheritedtext().white_space != white_space::T::pre { return } let position = match unscanned_text_fragment_info.text.find('\n') { Some(position) if position < unscanned_text_fragment_info.text.len() - 1 => { position } Some(_) | None => return, }; string_before = box unscanned_text_fragment_info.text[..(position + 1)].to_owned(); unscanned_text_fragment_info.text = box unscanned_text_fragment_info.text[(position + 1)..].to_owned(); } first_fragment.transform(first_fragment.border_box.size, SpecificFragmentInfo::UnscannedText(UnscannedTextFragmentInfo { text: string_before, })) }; fragments.push_front(new_fragment); } /// Information about a text run that we're about to create. This is used in `scan_for_runs`. struct RunInfo { /// The text that will go in this text run. text: String, /// The index of the applicable font in the font group. font_index: usize, /// A cached copy of the number of Unicode characters in the text run. character_length: usize, } impl RunInfo { fn new() -> RunInfo { RunInfo { text: String::new(), font_index: 0, character_length: 0, } } } /// A mapping from a portion of an unscanned text fragment to the text run we're going to create /// for it. #[derive(Copy, Clone, Debug)] struct RunMapping { /// The range of characters within the text fragment. range: Range, /// The index of the unscanned text fragment that this mapping corresponds to. old_fragment_index: usize, /// The index of the text run we're going to create. text_run_index: usize, } impl RunMapping { /// Given the current set of text runs, creates a run mapping for the next fragment. /// `run_info_list` describes the set of runs we've seen already, and `current_run_info` /// describes the run we just finished processing. fn new(run_info_list: &[RunInfo], current_run_info: &RunInfo, fragment_index: usize) -> RunMapping { RunMapping { range: Range::new(CharIndex(current_run_info.character_length as isize), CharIndex(0)), old_fragment_index: fragment_index, text_run_index: run_info_list.len(), } } /// Flushes this run mapping to the list. `run_info` describes the text run that we're /// currently working on. `text` refers to the text of this fragment. fn flush(mut self, mappings: &mut Vec, run_info: &mut RunInfo, text: &str, compression: CompressionMode, text_transform: text_transform::T, last_whitespace: &mut bool, start_position: &mut usize, end_position: usize) { let old_byte_length = run_info.text.len(); *last_whitespace = util::transform_text(&text[(*start_position)..end_position], compression, *last_whitespace, &mut run_info.text); // Account for `text-transform`. (Confusingly, this is not handled in "text // transformation" above, but we follow Gecko in the naming.) let character_count = apply_style_transform_if_necessary(&mut run_info.text, old_byte_length, text_transform); run_info.character_length = run_info.character_length + character_count; *start_position = end_position; // Don't flush empty mappings. if character_count == 0 { return } self.range.extend_by(CharIndex(character_count as isize)); mappings.push(self) } } /// Accounts for `text-transform`. /// /// FIXME(#4311, pcwalton): Case mapping can change length of the string; case mapping should /// be language-specific; `full-width`; use graphemes instead of characters. fn apply_style_transform_if_necessary(string: &mut String, first_character_position: usize, text_transform: text_transform::T) -> usize { match text_transform { text_transform::T::none => string[first_character_position..].chars().count(), text_transform::T::uppercase => { let original = string[first_character_position..].to_owned(); string.truncate(first_character_position); let mut count = 0; for character in original.chars() { string.push(character.to_uppercase().next().unwrap()); count += 1; } count } text_transform::T::lowercase => { let original = string[first_character_position..].to_owned(); string.truncate(first_character_position); let mut count = 0; for character in original.chars() { string.push(character.to_lowercase().next().unwrap()); count += 1; } count } text_transform::T::capitalize => { let original = string[first_character_position..].to_owned(); string.truncate(first_character_position); // FIXME(pcwalton): This may not always be correct in the case of something like // `foo`. let mut capitalize_next_letter = true; let mut count = 0; for character in original.chars() { count += 1; // FIXME(#4311, pcwalton): Should be the CSS/Unicode notion of a *typographic // letter unit*, not an *alphabetic* character: // // http://dev.w3.org/csswg/css-text/#typographic-letter-unit if capitalize_next_letter && character.is_alphabetic() { string.push(character.to_uppercase().next().unwrap()); capitalize_next_letter = false; continue } string.push(character); // FIXME(#4311, pcwalton): Try UAX29 instead of just whitespace. if character.is_whitespace() { capitalize_next_letter = true } } count } } }