Mapbox GL JS本地化实践文章中,有提到node-fontnik这个工具,用于把otfttf字体转换为Mapbox GL使用的protobuf格式的SDF字体。由于篇幅的问题,在那篇文章中,并没有详细介绍这个工具。但该工具对于字体的生成至关重要,所以还是需要详细说明一下。

字体加载约定

此处需要说明一点,Mapbox GL JS加载字体是采用的分段式加载,而不是整个字体库加载。假如是英文国家的字体,一次性加载整个字体库,也不会有多大,但如果是中文字体呢?微软雅黑字体都有10多M,一次性加载肯定会出现加载时间过长的问题。
具体如何分段加载?根据字符编码范围进行分段,Unicode字符采用2个字节编码,所以字符的编码的范围是[0, 65535],Mapbox GL JS按照每段长度256的方式,平均分为若干段。注意,每一段字体请求的命名方式为start-end.pbf。比如第一段则是0-255.pbf,依次是256-511.pbf512-767.pbf…。

工具使用

在了解上面的规则的情况下,就可以利用工具进行转换,需要说明的是,它是一个库,并不是直接可运行可执行程序。不能直接配置待转换的字体,输出转换结果。它只是提供了可供使用的接口,需要自己写代码来实现最后的转换。打开工具页面,里面有个API.md,列出了该工具提供的可用接口。
使用该库之前,按照readme的说明,在对应环境上安装好。最后编写代码完成最后一步的转换。此处贴出我编写的转换代码:

  1. var fontnik = require('.');
  2. var fs = require('fs');
  3. var path = require('path');
  4. var convert = function(fileName, outputDir) {
  5. var font = fs.readFileSync(path.resolve(__dirname + "/" + fileName));
  6. output2pbf(font, 0, 255, outputDir);
  7. }
  8. function output2pbf(font, start, end, outputDir) {
  9. if (start > 65535) {
  10. console.log("done!");
  11. return;
  12. }
  13. fontnik.range({font: font, start: start, end: end}, function(err, res) {
  14. var outputFilePath = path.resolve(__dirname + "/" + outputDir + start + "-" + end + ".pbf");
  15. fs.writeFile(outputFilePath, res, function(err){
  16. if(err) {
  17. console.error(err);
  18. } else {
  19. output2pbf(font, end+1, end+1+255, outputDir);
  20. }
  21. });
  22. });
  23. }
  24. convert("./fonts/NotoSansHans-Regular.otf", "./siyuan-pbf/Noto Sans Hans Regular/");
  25. convert("./fonts/NotoSansHans-Black.otf", "./siyuan-pbf/Noto Sans Hans Black/");
  26. convert("./fonts/NotoSansHans-Bold.otf", "./siyuan-pbf/Noto Sans Hans Bold/");
  27. convert("./fonts/NotoSansHans-DemiLight.otf", "./siyuan-pbf/Noto Sans Hans DemiLight/");
  28. convert("./fonts/NotoSansHans-Light.otf", "./siyuan-pbf/Noto Sans Hans Light/");
  29. convert("./fonts/NotoSansHans-Medium.otf", "./siyuan-pbf/Noto Sans Hans Medium/");
  30. convert("./fonts/NotoSansHans-Thin-Windows.otf", "./siyuan-pbf/Noto Sans Hans Thin Windows/");
  31. convert("./fonts/Microsoft-YaHei.ttf", "./yahei-pbf/Microsoft YaHei/");

我在代码中转换了开源的思源字体和微软雅黑字体。经验证,转换后的字体均可用。请放心尝试。
BTW:Mapbox GL JS的字体halo效果不错,有图有真相:

mapbox/node-fontnik工具使用介绍 - 图1