ddidderr
e536b603b2
Resolves the parity items of docs/rewrite/notes/review-rv17-codex.md (final-Z20.md): - FreeType-only font backend is also available on Apple targets (discovery-free, embedded emoji fonts); ghostty_surface_quicklook_font returns null for every backend except plain CoreText like Zig. - The +list-fonts test keys off the font crate's selected backend (HAS_DISCOVERY), correct under feature unification and on Apple. - Inspector font: 32 px rasterized with FreeType (dear-imgui freetype) like Ghostty; a new `visual-parity.sh inspector` scenario shows 0.031% differing pixels (hover highlight) vs the original on Linux. Windows, Apple and wasm keep stb_truetype at 32 px (registered as a deliberate deviation). - Inspector DCS/APC descriptions follow Zig 0.15.2's formatting (checked by running Zig), incl. the terminal.Parser.Action prefix. - The ImGui demo window appears only in dev-profile builds, mirroring Zig's .Debug-only gate. Test Plan: - cargo test --workspace --no-fail-fast (3582 passed) - just check-macos (both, also with --features font-backend-freetype) - scripts/visual-parity.sh inspector
80 lines
3.3 KiB
Rust
80 lines
3.3 KiB
Rust
//! Emits the font backend `cfg`s (port of `font/backend.zig`'s `Backend`
|
|
//! helpers `hasFreetype`/`hasCoretext`/`hasFontconfig`/`hasHarfbuzz`).
|
|
//!
|
|
//! Backends (see `src/backend.rs`):
|
|
//! * Linux & other non-Apple, non-wasm targets: `fontconfig_freetype`.
|
|
//! * Any non-wasm target (Apple included) with the cargo feature
|
|
//! `font-backend-freetype`: `freetype` (FreeType rendering, HarfBuzz
|
|
//! shaping, no font discovery; Zig `-Dfont-backend=freetype`). On Apple
|
|
//! it takes precedence over the `coretext-*` features.
|
|
//! * wasm32: `web_canvas`.
|
|
//! * Apple targets: `coretext` (default), or via cargo features
|
|
//! `coretext-freetype`, `coretext-harfbuzz`, `coretext-noshape`.
|
|
//!
|
|
//! Emitted cfgs:
|
|
//! * `font_freetype` - FreeType face / library are compiled.
|
|
//! * `font_fontconfig` - fontconfig discovery is compiled.
|
|
//! * `font_discovery` - a discovery mechanism (fontconfig or CoreText) exists
|
|
//! (Zig: `font.Discover != void`).
|
|
//! * `font_harfbuzz` - the HarfBuzz shaper is compiled.
|
|
//! * `font_coretext` - CoreText discovery/deferred face (Apple targets).
|
|
//! * `font_coretext_face` - the CoreText `Face` is the font face.
|
|
//! * `font_coretext_shaper` - the CoreText shaper is the shaper.
|
|
//! * `font_noshape` - the no-op shaper is the shaper.
|
|
|
|
fn main() {
|
|
println!("cargo:rerun-if-changed=build.rs");
|
|
for c in [
|
|
"font_freetype",
|
|
"font_fontconfig",
|
|
"font_discovery",
|
|
"font_harfbuzz",
|
|
"font_coretext",
|
|
"font_coretext_face",
|
|
"font_coretext_shaper",
|
|
"font_noshape",
|
|
] {
|
|
println!("cargo:rustc-check-cfg=cfg({c})");
|
|
}
|
|
|
|
let arch = std::env::var("CARGO_CFG_TARGET_ARCH").unwrap_or_default();
|
|
let vendor = std::env::var("CARGO_CFG_TARGET_VENDOR").unwrap_or_default();
|
|
let feat = |n: &str| std::env::var_os(format!("CARGO_FEATURE_{n}")).is_some();
|
|
|
|
let wasm = arch == "wasm32";
|
|
let apple = vendor == "apple";
|
|
let ct_ft = feat("CORETEXT_FREETYPE");
|
|
let ct_hb = feat("CORETEXT_HARFBUZZ");
|
|
let ct_noshape = feat("CORETEXT_NOSHAPE");
|
|
|
|
// Zig `-Dfont-backend=freetype` is valid on every non-wasm target,
|
|
// Darwin included (no discovery, so the embedded emoji fonts are used).
|
|
let ft_only = feat("FONT_BACKEND_FREETYPE");
|
|
if ft_only && wasm {
|
|
println!("cargo:warning=feature `font-backend-freetype` does not apply to wasm32; ignored");
|
|
}
|
|
let ft_only = ft_only && !wasm;
|
|
// CoreText is the backend on Apple targets unless FreeType-only is asked.
|
|
let coretext = apple && !ft_only;
|
|
|
|
let on = |c: &str, v: bool| {
|
|
if v {
|
|
println!("cargo:rustc-cfg={c}");
|
|
}
|
|
};
|
|
|
|
let freetype = !wasm && (!coretext || ct_ft);
|
|
let harfbuzz = !wasm && (!coretext || ct_ft || ct_hb);
|
|
on("font_freetype", freetype);
|
|
let fontconfig = !wasm && !apple && !ft_only;
|
|
on("font_fontconfig", fontconfig);
|
|
on("font_discovery", fontconfig || coretext);
|
|
on("font_harfbuzz", harfbuzz);
|
|
on("font_coretext", coretext);
|
|
on("font_coretext_face", coretext && !ct_ft);
|
|
// The shaper is CoreText only for the plain `coretext` backend;
|
|
// `coretext_noshape` uses the no-op shaper.
|
|
on("font_coretext_shaper", coretext && !harfbuzz && !ct_noshape);
|
|
on("font_noshape", coretext && !harfbuzz && ct_noshape);
|
|
}
|