#distance-field #multi-channel #sdf #msdf #safe-bindings #mcsdf

msdfgen

为 msdfgen(多通道有符号距离场生成器)提供安全绑定

3 个不稳定版本

0.2.1 2023 年 1 月 17 日
0.2.0 2023 年 1 月 15 日
0.1.0 2020 年 2 月 26 日

223图形 API

每月下载量 35
用于 fdsm

MIT 许可证

4.5MB
42K SLoC

Rust 30K SLoC // 0.0% comments C++ 12K SLoC // 0.1% comments Visual Studio Project 536 SLoC Visual Studio Solution 51 SLoC

msdfgen 库的安全绑定

github crate docs MIT CI

  • msdfgen-sys 使用 bindgen 生成的基础层非安全绑定。
  • msdfgen 应由应用程序使用的高级安全绑定。

功能

  • ttf-parse 启用 ttf-parser 包集成,允许为特定字体的符号创建形状。
  • font 启用 font 包集成,允许为特定字体的符号创建形状。
  • freetype-rs 启用 freetype-rs 包集成,允许为特定字体的符号创建形状。
  • png 启用 png 包集成,允许从/作为 PNG 图像加载和保存位图。
  • all 启用所有支持的特性的元特性。

用法

use std::fs::File;
use notosans::REGULAR_TTF as FONT;
use ttf_parser::Face;
use msdfgen::{FontExt, Bitmap, Gray, Range, MsdfGeneratorConfig, FillRule, MID_VALUE};

let font = Face::from_slice(&FONT, 0).unwrap();

let glyph = font.glyph_index('A').unwrap();

let mut shape = font.glyph_shape(glyph).unwrap();

let width = 32;
let height = 32;

let bound = shape.get_bound();
let framing = bound.autoframe(width, height, Range::Px(4.0), None).unwrap();
let fill_rule = FillRule::default();

let mut bitmap = Bitmap::new(width, height);

shape.edge_coloring_simple(3.0, 0);

let config = MsdfGeneratorConfig::default();

shape.generate_msdf(&mut bitmap, &framing, &config);

// optionally
shape.correct_sign(&mut bitmap, &framing, fill_rule);
shape.correct_msdf_error(&mut bitmap, &framing, &config);

let error = shape.estimate_error(&mut bitmap, &framing, 5, Default::default());

println!("Estimated error: {}", error);

bitmap.flip_y();

let mut output = File::create("A-letter-msdf.png").unwrap();
bitmap.write_png(&mut output).unwrap();

let mut preview = Bitmap::<Gray<f32>>::new(width * 10, height * 10);
bitmap.render(&mut preview, Default::default(), MID_VALUE);

let mut output = File::create("A-letter-preview.png").unwrap();
preview.write_png(&mut output).unwrap();

依赖关系

~9.5MB
~190K SLoC