From adbcf69a8dd2734fac2ed448b47626f02407ab93 Mon Sep 17 00:00:00 2001
From: Laurenz Stampfl <47084093+LaurenzV@users.noreply.github.com>
Date: Sat, 30 Nov 2024 12:38:24 +0100
Subject: [PATCH] Allow disabling using color tables for fonts

---
 crates/krilla/src/font/bitmap.rs             |   4 +--
 crates/krilla/src/font/colr.rs               |   6 ++--
 crates/krilla/src/font/mod.rs                |  24 +++++++++++---
 crates/krilla/src/font/svg.rs                |  10 ++++--
 crates/krilla/src/object/font/cid_font.rs    |  16 +++++-----
 crates/krilla/src/object/font/type3_font.rs  |   6 ++--
 crates/krilla/src/serialize.rs               |  16 ++++++----
 crates/krilla/src/surface.rs                 |  32 +++++++++----------
 crates/krilla/src/tagging.rs                 |   2 +-
 crates/krilla/src/tests/mod.rs               |   3 +-
 crates/krilla/src/validation/mod.rs          |  14 ++++----
 refs/visreg/twitter_color_emoji_no_color.png | Bin 0 -> 31160 bytes
 12 files changed, 80 insertions(+), 53 deletions(-)
 create mode 100644 refs/visreg/twitter_color_emoji_no_color.png

diff --git a/crates/krilla/src/font/bitmap.rs b/crates/krilla/src/font/bitmap.rs
index a295f70d..d411a377 100644
--- a/crates/krilla/src/font/bitmap.rs
+++ b/crates/krilla/src/font/bitmap.rs
@@ -451,7 +451,7 @@ mod tests {
     #[visreg(document, pdfium, mupdf, pdfbox, ghostscript, poppler, quartz)]
     fn noto_color_emoji_cbdt(document: &mut Document) {
         let font_data = NOTO_COLOR_EMOJI_CBDT.clone();
-        all_glyphs_to_pdf(font_data, None, false, document);
+        all_glyphs_to_pdf(font_data, None, false, true, document);
     }
 
     #[cfg(target_os = "macos")]
@@ -461,6 +461,6 @@ mod tests {
 
         let font_data =
             Arc::new(std::fs::read("/System/Library/Fonts/Apple Color Emoji.ttc").unwrap());
-        all_glyphs_to_pdf(font_data, None, false, document);
+        all_glyphs_to_pdf(font_data, None, false, true, document);
     }
 }
diff --git a/crates/krilla/src/font/colr.rs b/crates/krilla/src/font/colr.rs
index 0bda36a6..a5ba3e5f 100644
--- a/crates/krilla/src/font/colr.rs
+++ b/crates/krilla/src/font/colr.rs
@@ -480,13 +480,13 @@ mod tests {
             .map(|n| (GlyphId::new(n), "".to_string()))
             .collect::<Vec<_>>();
 
-        all_glyphs_to_pdf(font_data, Some(glyphs), false, document);
+        all_glyphs_to_pdf(font_data, Some(glyphs), false, true, document);
     }
 
     #[visreg]
     fn colr_context_color(surface: &mut Surface) {
         let font_data = COLR_TEST_GLYPHS.clone();
-        let font = Font::new(font_data, 0).unwrap();
+        let font = Font::new(font_data, 0, true).unwrap();
 
         let text = [
             0xf0b00, 0xf0b01, 0xf0b02, 0xf0b03, 0xf0b04, 0xf0b05, 0xf0b06, 0xf0b07,
@@ -570,6 +570,6 @@ mod tests {
     #[visreg(document, pdfium, mupdf, pdfbox, ghostscript, poppler, quartz)]
     fn noto_color_emoji_colr(document: &mut Document) {
         let font_data = NOTO_COLOR_EMOJI_COLR.clone();
-        all_glyphs_to_pdf(font_data, None, false, document);
+        all_glyphs_to_pdf(font_data, None, false, true, document);
     }
 }
diff --git a/crates/krilla/src/font/mod.rs b/crates/krilla/src/font/mod.rs
index 549e55a6..8169da61 100644
--- a/crates/krilla/src/font/mod.rs
+++ b/crates/krilla/src/font/mod.rs
@@ -51,14 +51,24 @@ pub use skrifa::GlyphId;
 pub struct Font(Arc<Prehashed<Repr>>);
 
 impl Font {
-    /// Create a new font from some data. The `index` indicates the index that should be
+    /// Create a new font from some data.
+    ///
+    /// The `index` indicates the index that should be
     /// associated with this font for TrueType collections, otherwise this value should be
     /// set to 0. The location indicates the variation axes that should be associated with
     /// the font.
     ///
+    /// The `allow_color` property allows you to specify whether krilla should render the font
+    /// as a color font. When setting this property to false, krilla will always only use the
+    /// `glyf`/`CFF` tables of the font. If you don't know what this means, just set it to `true`.
+    ///
     /// Returns `None` if the index is invalid or the font couldn't be read.
-    pub fn new(data: Arc<dyn AsRef<[u8]> + Send + Sync>, index: u32) -> Option<Self> {
-        let font_info = FontInfo::new(data.as_ref().as_ref(), index)?;
+    pub fn new(
+        data: Arc<dyn AsRef<[u8]> + Send + Sync>,
+        index: u32,
+        allow_color: bool,
+    ) -> Option<Self> {
+        let font_info = FontInfo::new(data.as_ref().as_ref(), index, allow_color)?;
 
         Font::new_with_info(data, Arc::new(font_info))
     }
@@ -108,6 +118,10 @@ impl Font {
         self.0.font_info.ascent.get()
     }
 
+    pub(crate) fn allow_color(&self) -> bool {
+        self.0.font_info.allow_color
+    }
+
     pub(crate) fn weight(&self) -> f32 {
         self.0.font_info.weight.get()
     }
@@ -182,6 +196,7 @@ pub(crate) struct FontInfo {
     global_bbox: RectWrapper,
     postscript_name: Option<String>,
     ascent: FiniteF32,
+    allow_color: bool,
     descent: FiniteF32,
     cap_height: Option<FiniteF32>,
     is_monospaced: bool,
@@ -208,7 +223,7 @@ impl Hash for Repr {
 }
 
 impl FontInfo {
-    pub(crate) fn new(data: &[u8], index: u32) -> Option<Self> {
+    pub(crate) fn new(data: &[u8], index: u32, allow_color: bool) -> Option<Self> {
         let font_ref = FontRef::from_index(data, index).ok()?;
         let checksum = font_ref.head().ok()?.checksum_adjustment();
 
@@ -252,6 +267,7 @@ impl FontInfo {
             index,
             checksum,
             location,
+            allow_color,
             units_per_em,
             postscript_name,
             ascent,
diff --git a/crates/krilla/src/font/svg.rs b/crates/krilla/src/font/svg.rs
index 8b615652..5fa097cd 100644
--- a/crates/krilla/src/font/svg.rs
+++ b/crates/krilla/src/font/svg.rs
@@ -80,13 +80,19 @@ mod tests {
     #[visreg(document, all)]
     fn twitter_color_emoji(document: &mut Document) {
         let font_data = TWITTER_COLOR_EMOJI.clone();
-        all_glyphs_to_pdf(font_data, None, false, document);
+        all_glyphs_to_pdf(font_data, None, false, true, document);
+    }
+
+    #[visreg(document)]
+    fn twitter_color_emoji_no_color(document: &mut Document) {
+        let font_data = TWITTER_COLOR_EMOJI.clone();
+        all_glyphs_to_pdf(font_data, None, false, false, document);
     }
 
     #[visreg]
     fn svg_extra(surface: &mut Surface) {
         let font_data = SVG_EXTRA.clone();
-        let font = Font::new(font_data, 0).unwrap();
+        let font = Font::new(font_data, 0, true).unwrap();
 
         surface.fill_text(
             Point::from_xy(0., 30.0),
diff --git a/crates/krilla/src/object/font/cid_font.rs b/crates/krilla/src/object/font/cid_font.rs
index 6b125d10..87c2a122 100644
--- a/crates/krilla/src/object/font/cid_font.rs
+++ b/crates/krilla/src/object/font/cid_font.rs
@@ -357,7 +357,7 @@ mod tests {
 
     #[snapshot]
     fn cid_font_noto_sans_two_glyphs(sc: &mut SerializerContext) {
-        let font = Font::new(NOTO_SANS.clone(), 0).unwrap();
+        let font = Font::new(NOTO_SANS.clone(), 0, true).unwrap();
         let container = sc.create_or_get_font_container(font.clone());
         let mut font_container = container.borrow_mut();
 
@@ -374,7 +374,7 @@ mod tests {
 
     #[visreg(all)]
     fn cid_font_noto_sans_simple_text(surface: &mut Surface) {
-        let font = Font::new(NOTO_SANS.clone(), 0).unwrap();
+        let font = Font::new(NOTO_SANS.clone(), 0, true).unwrap();
         surface.fill_text(
             Point::from_xy(0.0, 100.0),
             Fill::default(),
@@ -389,7 +389,7 @@ mod tests {
 
     #[visreg(all)]
     fn cid_font_latin_modern_simple_text(surface: &mut Surface) {
-        let font = Font::new(LATIN_MODERN_ROMAN.clone(), 0).unwrap();
+        let font = Font::new(LATIN_MODERN_ROMAN.clone(), 0, true).unwrap();
         surface.fill_text(
             Point::from_xy(0.0, 100.0),
             Fill::default(),
@@ -404,7 +404,7 @@ mod tests {
 
     #[visreg(all)]
     fn cid_font_noto_arabic_simple_text(surface: &mut Surface) {
-        let font = Font::new(NOTO_SANS_ARABIC.clone(), 0).unwrap();
+        let font = Font::new(NOTO_SANS_ARABIC.clone(), 0, true).unwrap();
         surface.fill_text(
             Point::from_xy(0.0, 100.0),
             Fill::default(),
@@ -419,7 +419,7 @@ mod tests {
 
     #[snapshot]
     fn cid_font_latin_modern_four_glyphs(sc: &mut SerializerContext) {
-        let font = Font::new(LATIN_MODERN_ROMAN.clone(), 0).unwrap();
+        let font = Font::new(LATIN_MODERN_ROMAN.clone(), 0, true).unwrap();
         let container = sc.create_or_get_font_container(font.clone());
         let mut font_container = container.borrow_mut();
 
@@ -445,9 +445,9 @@ mod tests {
 
         let font_data =
             Arc::new(std::fs::read("/System/Library/Fonts/Supplemental/Songti.ttc").unwrap());
-        let font_1 = Font::new(font_data.clone(), 0).unwrap();
-        let font_2 = Font::new(font_data.clone(), 3).unwrap();
-        let font_3 = Font::new(font_data, 6).unwrap();
+        let font_1 = Font::new(font_data.clone(), 0, true).unwrap();
+        let font_2 = Font::new(font_data.clone(), 3, true).unwrap();
+        let font_3 = Font::new(font_data, 6, true).unwrap();
 
         surface.fill_text(
             Point::from_xy(0.0, 75.0),
diff --git a/crates/krilla/src/object/font/type3_font.rs b/crates/krilla/src/object/font/type3_font.rs
index e1a6fa76..b4e35b59 100644
--- a/crates/krilla/src/object/font/type3_font.rs
+++ b/crates/krilla/src/object/font/type3_font.rs
@@ -552,7 +552,7 @@ mod tests {
     #[test]
     fn type3_more_than_256_glyphs() {
         let mut sc = SerializerContext::new(SerializeSettings::settings_1());
-        let font = Font::new(TWITTER_COLOR_EMOJI.clone(), 0).unwrap();
+        let font = Font::new(TWITTER_COLOR_EMOJI.clone(), 0, true).unwrap();
         let container = sc.create_or_get_font_container(font.clone());
         let mut font_container = container.borrow_mut();
 
@@ -586,7 +586,7 @@ mod tests {
 
     #[snapshot(single_page, settings_1)]
     fn type3_color_glyphs(page: &mut Page) {
-        let font = Font::new(TWITTER_COLOR_EMOJI.clone(), 0).unwrap();
+        let font = Font::new(TWITTER_COLOR_EMOJI.clone(), 0, true).unwrap();
         let mut surface = page.surface();
 
         surface.fill_text(
@@ -603,7 +603,7 @@ mod tests {
 
     #[snapshot(single_page, settings_17)]
     fn type3_pdf_14(page: &mut Page) {
-        let font = Font::new(TWITTER_COLOR_EMOJI.clone(), 0).unwrap();
+        let font = Font::new(TWITTER_COLOR_EMOJI.clone(), 0, true).unwrap();
         let mut surface = page.surface();
 
         surface.fill_text(
diff --git a/crates/krilla/src/serialize.rs b/crates/krilla/src/serialize.rs
index 2b79e4b3..edfe07d8 100644
--- a/crates/krilla/src/serialize.rs
+++ b/crates/krilla/src/serialize.rs
@@ -425,11 +425,15 @@ impl SerializerContext {
                 // For now, we make the simplifying assumption that a font is either mapped
                 // to a series of Type3 fonts or to a single CID font, but not a mix of both.
                 let font_ref = font.font_ref();
-                let use_type3 = font_ref.svg().is_ok()
-                    || font_ref.colr().is_ok()
-                    || font_ref.sbix().is_ok()
-                    || font_ref.cbdt().is_ok()
-                    || font_ref.ebdt().is_ok();
+                let use_type3 = if !font.allow_color() {
+                    false
+                } else {
+                    font_ref.svg().is_ok()
+                        || font_ref.colr().is_ok()
+                        || font_ref.sbix().is_ok()
+                        || font_ref.cbdt().is_ok()
+                        || font_ref.ebdt().is_ok()
+                };
 
                 if use_type3 {
                     Rc::new(RefCell::new(FontContainer::Type3(Type3FontMapper::new(
@@ -487,7 +491,7 @@ impl SerializerContext {
             // cheaper, and then check whether we already have a corresponding font object in the cache.
             // If not, we still need to construct it.
             if let Some((font_data, index)) = unsafe { db.make_shared_face_data(id) } {
-                if let Some(font_info) = FontInfo::new(font_data.as_ref().as_ref(), index) {
+                if let Some(font_info) = FontInfo::new(font_data.as_ref().as_ref(), index, true) {
                     let font_info = Arc::new(font_info);
                     let font = self
                         .font_cache
diff --git a/crates/krilla/src/surface.rs b/crates/krilla/src/surface.rs
index d78f85ae..625c0d21 100644
--- a/crates/krilla/src/surface.rs
+++ b/crates/krilla/src/surface.rs
@@ -658,7 +658,7 @@ mod tests {
 
     #[visreg]
     fn text_direction_ltr(surface: &mut Surface) {
-        let font = Font::new(NOTO_SANS_CJK.clone(), 0).unwrap();
+        let font = Font::new(NOTO_SANS_CJK.clone(), 0, true).unwrap();
         surface.fill_text(
             Point::from_xy(0.0, 100.0),
             Fill::default(),
@@ -673,7 +673,7 @@ mod tests {
 
     #[visreg]
     fn text_direction_rtl(surface: &mut Surface) {
-        let font = Font::new(NOTO_SANS_CJK.clone(), 0).unwrap();
+        let font = Font::new(NOTO_SANS_CJK.clone(), 0, true).unwrap();
         surface.fill_text(
             Point::from_xy(0.0, 100.0),
             Fill::default(),
@@ -688,7 +688,7 @@ mod tests {
 
     #[visreg]
     fn text_direction_ttb(surface: &mut Surface) {
-        let font = Font::new(NOTO_SANS_CJK.clone(), 0).unwrap();
+        let font = Font::new(NOTO_SANS_CJK.clone(), 0, true).unwrap();
         surface.fill_text(
             Point::from_xy(100.0, 0.0),
             Fill::default(),
@@ -703,7 +703,7 @@ mod tests {
 
     #[visreg]
     fn text_direction_btt(surface: &mut Surface) {
-        let font = Font::new(NOTO_SANS_CJK.clone(), 0).unwrap();
+        let font = Font::new(NOTO_SANS_CJK.clone(), 0, true).unwrap();
         surface.fill_text(
             Point::from_xy(100.0, 0.0),
             Fill::default(),
@@ -783,7 +783,7 @@ mod tests {
         surface.fill_text(
             Point::from_xy(0.0, 50.0),
             Fill::default(),
-            Font::new(NOTO_SANS.clone(), 0).unwrap(),
+            Font::new(NOTO_SANS.clone(), 0, true).unwrap(),
             16.0,
             &[],
             "hi there",
@@ -797,7 +797,7 @@ mod tests {
         surface.stroke_text(
             Point::from_xy(0.0, 50.0),
             Stroke::default(),
-            Font::new(NOTO_SANS.clone(), 0).unwrap(),
+            Font::new(NOTO_SANS.clone(), 0, true).unwrap(),
             16.0,
             &[],
             "hi there",
@@ -811,7 +811,7 @@ mod tests {
         surface.fill_text(
             Point::from_xy(0.0, 50.0),
             Fill::default(),
-            Font::new(NOTO_SANS_DEVANAGARI.clone(), 0).unwrap(),
+            Font::new(NOTO_SANS_DEVANAGARI.clone(), 0, true).unwrap(),
             16.0,
             &[],
             "यह कुछ जटिल पाठ है.",
@@ -825,7 +825,7 @@ mod tests {
         surface.fill_text(
             Point::from_xy(0.0, 50.0),
             Fill::default(),
-            Font::new(NOTO_SANS_DEVANAGARI.clone(), 0).unwrap(),
+            Font::new(NOTO_SANS_DEVANAGARI.clone(), 0, true).unwrap(),
             16.0,
             &[],
             "यु॒धा नर॑ ऋ॒ष्वा ",
@@ -839,7 +839,7 @@ mod tests {
         surface.fill_text(
             Point::from_xy(0.0, 50.0),
             Fill::default(),
-            Font::new(NOTO_SANS_DEVANAGARI.clone(), 0).unwrap(),
+            Font::new(NOTO_SANS_DEVANAGARI.clone(), 0, true).unwrap(),
             16.0,
             &[],
             "आ रु॒क्मैरा यु॒धा नर॑ ऋ॒ष्वा ऋ॒ष्टीर॑सृक्षत ।",
@@ -853,7 +853,7 @@ mod tests {
         surface.fill_text(
             Point::from_xy(0.0, 50.0),
             Fill::default(),
-            Font::new(NOTO_SANS_DEVANAGARI.clone(), 0).unwrap(),
+            Font::new(NOTO_SANS_DEVANAGARI.clone(), 0, true).unwrap(),
             16.0,
             &[],
             "अन्वे॑नाँ॒ अह॑ वि॒द्युतो॑ म॒रुतो॒ जज्झ॑तीरव भनर॑र्त॒ त्मना॑ दि॒वः ॥",
@@ -956,7 +956,7 @@ mod tests {
     }
 
     fn text_with_fill_impl(surface: &mut Surface, outlined: bool) {
-        let font = Font::new(NOTO_SANS.clone(), 0).unwrap();
+        let font = Font::new(NOTO_SANS.clone(), 0, true).unwrap();
         surface.fill_text(
             Point::from_xy(0.0, 80.0),
             red_fill(0.5),
@@ -995,7 +995,7 @@ mod tests {
             TextDirection::Auto,
         );
 
-        let noto_font = Font::new(NOTO_COLOR_EMOJI_COLR.clone(), 0).unwrap();
+        let noto_font = Font::new(NOTO_COLOR_EMOJI_COLR.clone(), 0, true).unwrap();
 
         surface.fill_text(
             Point::from_xy(0.0, 140.0),
@@ -1031,7 +1031,7 @@ mod tests {
     }
 
     fn text_with_stroke_impl(surface: &mut Surface, outlined: bool) {
-        let font = Font::new(NOTO_SANS.clone(), 0).unwrap();
+        let font = Font::new(NOTO_SANS.clone(), 0, true).unwrap();
         surface.stroke_text(
             Point::from_xy(0.0, 80.0),
             red_stroke(0.5, 1.0),
@@ -1070,7 +1070,7 @@ mod tests {
             TextDirection::Auto,
         );
 
-        let font = Font::new(NOTO_COLOR_EMOJI_COLR.clone(), 0).unwrap();
+        let font = Font::new(NOTO_COLOR_EMOJI_COLR.clone(), 0, true).unwrap();
 
         surface.stroke_text(
             Point::from_xy(0.0, 140.0),
@@ -1091,7 +1091,7 @@ mod tests {
 
     #[visreg]
     fn text_zalgo(surface: &mut Surface) {
-        let font = Font::new(NOTO_SANS.clone(), 0).unwrap();
+        let font = Font::new(NOTO_SANS.clone(), 0, true).unwrap();
         surface.fill_text(
             Point::from_xy(0.0, 100.0),
             Fill::default(),
@@ -1106,7 +1106,7 @@ mod tests {
 
     #[visreg]
     fn text_zalgo_outlined(surface: &mut Surface) {
-        let font = Font::new(NOTO_SANS.clone(), 0).unwrap();
+        let font = Font::new(NOTO_SANS.clone(), 0, true).unwrap();
         surface.fill_text(
             Point::from_xy(0.0, 100.0),
             Fill::default(),
diff --git a/crates/krilla/src/tagging.rs b/crates/krilla/src/tagging.rs
index 80ea0fe3..f7af4b3f 100644
--- a/crates/krilla/src/tagging.rs
+++ b/crates/krilla/src/tagging.rs
@@ -949,7 +949,7 @@ mod tests {
     impl SurfaceExt for Surface<'_> {
         fn fill_text_(&mut self, y: f32, content: &str) {
             let font_data = NOTO_SANS.clone();
-            let font = Font::new(font_data, 0).unwrap();
+            let font = Font::new(font_data, 0, true).unwrap();
 
             self.fill_text(
                 tiny_skia_path::Point::from_xy(0.0, y),
diff --git a/crates/krilla/src/tests/mod.rs b/crates/krilla/src/tests/mod.rs
index 29831144..853e1482 100644
--- a/crates/krilla/src/tests/mod.rs
+++ b/crates/krilla/src/tests/mod.rs
@@ -439,12 +439,13 @@ pub fn all_glyphs_to_pdf(
     font_data: Arc<Vec<u8>>,
     glyphs: Option<Vec<(GlyphId, String)>>,
     color_cycling: bool,
+    allow_color: bool,
     d: &mut Document,
 ) {
     use crate::font::KrillaGlyph;
     use crate::geom::Transform;
 
-    let font = Font::new(font_data, 0).unwrap();
+    let font = Font::new(font_data, 0, allow_color).unwrap();
     let font_ref = font.font_ref();
 
     let glyphs = glyphs.unwrap_or_else(|| {
diff --git a/crates/krilla/src/validation/mod.rs b/crates/krilla/src/validation/mod.rs
index 47ce0af4..d2a39d62 100644
--- a/crates/krilla/src/validation/mod.rs
+++ b/crates/krilla/src/validation/mod.rs
@@ -677,7 +677,7 @@ mod tests {
         let mut surface = page.surface();
 
         let font_data = NOTO_SANS.clone();
-        let font = Font::new(font_data, 0).unwrap();
+        let font = Font::new(font_data, 0, true).unwrap();
 
         surface.fill_text(
             Point::from_xy(0.0, 100.0),
@@ -705,7 +705,7 @@ mod tests {
         let mut surface = page.surface();
 
         let font_data = NOTO_SANS.clone();
-        let font = Font::new(font_data, 0).unwrap();
+        let font = Font::new(font_data, 0, true).unwrap();
 
         surface.fill_text(
             Point::from_xy(0.0, 100.0),
@@ -729,7 +729,7 @@ mod tests {
         let mut surface = page.surface();
 
         let font_data = NOTO_SANS.clone();
-        let font = Font::new(font_data, 0).unwrap();
+        let font = Font::new(font_data, 0, true).unwrap();
 
         let id1 = surface.start_tagged(ContentTag::Span(
             "",
@@ -792,7 +792,7 @@ mod tests {
     fn validation_pdfu_invalid_codepoint() {
         let mut document = Document::new_with(SerializeSettings::settings_9());
         let font_data = NOTO_SANS.clone();
-        let font = Font::new(font_data, 0).unwrap();
+        let font = Font::new(font_data, 0, true).unwrap();
         invalid_codepoint_impl(&mut document, font.clone(), "A\u{FEFF}B");
 
         assert_eq!(
@@ -809,7 +809,7 @@ mod tests {
         let metadata = Metadata::new().language("en".to_string());
         document.set_metadata(metadata);
         let font_data = NOTO_SANS.clone();
-        let font = Font::new(font_data, 0).unwrap();
+        let font = Font::new(font_data, 0, true).unwrap();
         invalid_codepoint_impl(&mut document, font.clone(), "A\u{E022}B");
 
         assert_eq!(
@@ -866,7 +866,7 @@ mod tests {
         let mut surface = page.surface();
 
         let font_data = NOTO_SANS.clone();
-        let font = Font::new(font_data, 0).unwrap();
+        let font = Font::new(font_data, 0, true).unwrap();
 
         let id1 = surface.start_tagged(ContentTag::Span("", None, None, None));
         surface.fill_text(
@@ -914,7 +914,7 @@ mod tests {
         let mut surface = page.surface();
 
         let font_data = NOTO_SANS.clone();
-        let font = Font::new(font_data, 0).unwrap();
+        let font = Font::new(font_data, 0, true).unwrap();
 
         let id1 = surface.start_tagged(ContentTag::Span("", None, None, None));
         surface.fill_text(
diff --git a/refs/visreg/twitter_color_emoji_no_color.png b/refs/visreg/twitter_color_emoji_no_color.png
new file mode 100644
index 0000000000000000000000000000000000000000..3e461f27b3b5d801022a176b1a28932241fe9f48
GIT binary patch
literal 31160
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
b)4l&6N3cb0B}o0s00000NkvXXu0mjf<Xl%H

literal 0
HcmV?d00001