GitCorner

Code

ossartcrafteffectcraft๐ŸŒ
665bfac0b339
//! M13.12: transparency groups (isolated, knockout, group alpha) and soft masks on a group's
//! combined result.

use crate::tests::{page_pdf, render};
use crate::*;

fn near(a: [f32; 4], b: [f32; 4]) -> bool {
    (0..4).all(|i| (a[i] - b[i]).abs() < 0.02)
}

/// A page painting form `Fm` with graphics state `GS` set; the form has `group` as its
/// `/Group` entry body and `content`.
fn group_page(page: &str, gs: &str, group: &str, content: &str) -> Doc {
    let bytes = page_pdf(
        page,
        &format!("/ExtGState << /GS << {gs} >> /M << /BM /Multiply >> /H << /ca 0.5 >> >> /XObject << /Fm 10 0 R >>"),
        vec![(
            10,
            format!(
                "<< /Type /XObject /Subtype /Form /BBox [0 0 200 100] {group} /Resources << /ExtGState << /M << /BM /Multiply >> /H << /ca 0.5 >> >> >> >>"
            ),
            Some(content.as_bytes().to_vec()),
        )],
    );
    let doc = parse(&bytes).unwrap();
    assert!(doc.skipped.is_empty(), "{:?}", doc.skipped);
    doc
}

#[test]
fn group_alpha_applies_to_the_combined_result() {
    let content = "1 0 0 rg 0 0 100 100 re f 0 0 1 rg 50 0 100 100 re f";
    // A transparency group: the overlap is blue at half opacity (no red shows through).
    let doc = group_page("/GS gs /Fm Do", "/ca 0.5", "/Group << /S /Transparency >>", content);
    let img = render(&doc);
    assert!(near(img.get(75, 50), [0.0, 0.0, 0.5, 0.5]), "{:?}", img.get(75, 50));
    assert!(near(img.get(25, 50), [0.5, 0.0, 0.0, 0.5]), "{:?}", img.get(25, 50));
    // A plain form: each rectangle at half opacity.
    let doc = group_page("/GS gs /Fm Do", "/ca 0.5", "", content);
    let img = render(&doc);
    assert!(near(img.get(75, 50), [0.25, 0.0, 0.5, 0.75]), "{:?}", img.get(75, 50));
}

#[test]
fn knockout_groups_composite_with_the_initial_backdrop() {
    // Red, then half-opaque blue over it: knocked out, the overlap shows only the blue.
    let content = "1 0 0 rg 0 0 100 100 re f /H gs 0 0 1 rg 50 0 100 100 re f";
    let ko = group_page("/Fm Do", "", "/Group << /S /Transparency /I true /K true >>", content);
    let img = render(&ko);
    assert!(near(img.get(75, 50), [0.0, 0.0, 0.5, 0.5]), "knockout {:?}", img.get(75, 50));
    assert!(near(img.get(25, 50), [1.0, 0.0, 0.0, 1.0]), "{:?}", img.get(25, 50));
    let plain = group_page("/Fm Do", "", "/Group << /S /Transparency /I true >>", content);
    let img = render(&plain);
    assert!(near(img.get(75, 50), [0.5, 0.0, 0.5, 1.0]), "plain {:?}", img.get(75, 50));
    // Non-isolated knockout over a white page: the overlap is half blue over the page.
    let ko_bd = group_page("1 g 0 0 200 100 re f /Fm Do", "", "/Group << /S /Transparency /K true >>", content);
    let img = render(&ko_bd);
    assert!(near(img.get(75, 50), [0.5, 0.5, 1.0, 1.0]), "non-isolated knockout {:?}", img.get(75, 50));
}

#[test]
fn isolated_and_non_isolated_groups_with_blend_modes() {
    // Yellow page; the group multiplies cyan over it at half group opacity.
    let content = "/M gs 0 1 1 rg 0 0 200 100 re f";
    let non = group_page("1 1 0 rg 0 0 200 100 re f /GS gs /Fm Do", "/ca 0.5", "/Group << /S /Transparency >>", content);
    let img = render(&non);
    // yellow ร— cyan = green, half over yellow.
    assert!(near(img.get(100, 50), [0.5, 1.0, 0.0, 1.0]), "non-isolated {:?}", img.get(100, 50));
    let iso = group_page("1 1 0 rg 0 0 200 100 re f /GS gs /Fm Do", "/ca 0.5", "/Group << /S /Transparency /I true >>", content);
    let img = render(&iso);
    // Isolated: multiply against nothing = cyan, half over yellow.
    assert!(near(img.get(100, 50), [0.5, 1.0, 0.5, 1.0]), "isolated {:?}", img.get(100, 50));
}

#[test]
fn blend_modes_inside_clips_reach_the_backdrop() {
    let bytes = page_pdf("1 1 0 rg 0 0 200 100 re f q 0 0 100 100 re W n /M gs 0 1 1 rg 0 0 200 100 re f Q", "/ExtGState << /M << /BM /Multiply >> >>", vec![]);
    let img = render(&parse(&bytes).unwrap());
    assert!(near(img.get(50, 50), [0.0, 1.0, 0.0, 1.0]), "{:?}", img.get(50, 50));
    assert!(near(img.get(150, 50), [1.0, 1.0, 0.0, 1.0]), "{:?}", img.get(150, 50));
}

#[test]
fn soft_mask_applies_to_the_masked_group_result() {
    // Two overlapping opaque rectangles under a 50 % grey luminosity mask: the overlap is
    // the top rectangle at half opacity (the mask applies to their composite).
    let bytes = page_pdf(
        "q /GS1 gs 1 0 0 rg 0 0 100 100 re f 0 0 1 rg 50 0 100 100 re f Q",
        "/ExtGState << /GS1 << /SMask << /S /Luminosity /G 10 0 R >> >> >>",
        vec![(
            10,
            "<< /Type /XObject /Subtype /Form /BBox [0 0 200 100] /Group << /S /Transparency /CS /DeviceGray >> >>".into(),
            Some(b"0.5 g 0 0 200 100 re f".to_vec()),
        )],
    );
    let img = render(&parse(&bytes).unwrap());
    let p = img.get(75, 50);
    assert!((p[3] - 0.5).abs() < 0.02 && p[0] < 0.02 && (p[2] - 0.5).abs() < 0.02, "{p:?}");
}

/// The ink bounding box `(x0, y0, x1, y1)` of a render (pixels with alpha > 0.5).
fn ink_box(img: &effectcraft_raster::Image) -> (i64, i64, i64, i64) {
    let (mut x0, mut y0, mut x1, mut y1) = (i64::MAX, i64::MAX, i64::MIN, i64::MIN);
    for y in 0..img.height as i64 {
        for x in 0..img.width as i64 {
            if img.get(x, y)[3] > 0.5 {
                (x0, y0, x1, y1) = (x0.min(x), y0.min(y), x1.max(x), y1.max(y));
            }
        }
    }
    (x0, y0, x1, y1)
}

#[test]
fn vertical_metrics_w2_and_dw2() {
    use skrifa::MetadataProvider;
    let inter = effectcraft_text::fonts::INTER_REGULAR.to_vec();
    let font = skrifa::FontRef::new(&inter).unwrap();
    let h = font.charmap().map('H').unwrap().to_u32();
    let doc = |desc_extra: &str| {
        let bytes = page_pdf(
            &format!("BT /F1 20 Tf 100 95 Td <{h:04X}{h:04X}> Tj ET"),
            "/Font << /F1 10 0 R >>",
            vec![
                (10, "<< /Type /Font /Subtype /Type0 /BaseFont /Inter /Encoding /Identity-V /DescendantFonts [13 0 R] >>".into(), None),
                (
                    13,
                    format!(
                        "<< /Type /Font /Subtype /CIDFontType2 /BaseFont /Inter /CIDToGIDMap /Identity /W [{h} [700]] {desc_extra} /FontDescriptor 11 0 R >>"
                    ),
                    None,
                ),
                (11, "<< /Type /FontDescriptor /Flags 32 /FontFile2 12 0 R >>".into(), None),
                (12, "<< >>".into(), Some(inter.clone())),
            ],
        );
        let d = parse(&bytes).unwrap();
        assert!(d.skipped.is_empty(), "{:?}", d.skipped);
        ink_box(&render(&d))
    };
    // Defaults: an advance of 1 em down; the vertical origin (350, 880) from the horizontal one.
    let base = doc("");
    // /W2: a 2 em advance and vx 250.
    let w2 = doc(&format!("/W2 [{h} [-2000 250 880]]"));
    assert_eq!(w2.1, base.1, "the first glyph's top stays: {base:?} {w2:?}");
    assert!(((w2.3 - base.3) - 20).abs() <= 1, "second glyph 20 pt lower: {base:?} {w2:?}");
    assert!(((w2.0 - base.0) - 2).abs() <= 1, "vx 250 vs 350 โ†’ 2 pt right: {base:?} {w2:?}");
    // The range form gives the same; /DW2 with vy 780 draws the glyphs 2 pt higher.
    let range = doc(&format!("/W2 [{h} {h} -2000 250 880]"));
    assert_eq!(range, w2);
    let dw2 = doc("/DW2 [780 -1000]");
    assert!(((base.1 - dw2.1) - 2).abs() <= 1, "vy 780 โ†’ 2 pt higher: {base:?} {dw2:?}");
}

#[test]
fn actual_text_does_not_combine_knockout_children() {
    let plain = "1 0 0 rg 0 0 100 100 re f /H gs 0 0 1 rg 50 0 100 100 re f";
    let marked = format!("/Span << /ActualText (Label) >> BDC {plain} EMC");
    let a = render(&group_page("/Fm Do", "", "/Group << /S /Transparency /I true /K true >>", plain));
    let b = render(&group_page("/Fm Do", "", "/Group << /S /Transparency /I true /K true >>", &marked));
    for y in 0..100 {
        for x in 0..200 {
            assert!(near(a.get(x, y), b.get(x, y)), "pixel {x},{y}");
        }
    }
}

#[test]
fn actual_text_end_keeps_soft_mask_and_overlapping_paints() {
    let plain = "/GS1 gs 1 0 0 rg 0 0 100 100 re f 0 0 1 rg 50 0 100 100 re f";
    let marked = "/Span << /ActualText (Label) >> BDC /GS1 gs 1 0 0 rg 0 0 100 100 re f EMC 0 0 1 rg 50 0 100 100 re f";
    let draw = |ops| {
        let bytes = page_pdf(
            ops,
            "/ExtGState << /GS1 << /SMask << /S /Luminosity /G 10 0 R >> >> >>",
            vec![(
                10,
                "<< /Type /XObject /Subtype /Form /BBox [0 0 200 100] /Group << /S /Transparency /CS /DeviceGray >> >>".into(),
                Some(b"0.5 g 0 0 200 100 re f".to_vec()),
            )],
        );
        render(&parse(&bytes).unwrap())
    };
    let (a, b) = (draw(plain), draw(marked));
    for y in 0..100 {
        for x in 0..200 {
            assert!(near(a.get(x, y), b.get(x, y)), "pixel {x},{y}");
        }
    }
}