关于发布及TODO

[alephpi]

你好若舟，

1. 不知你是否考虑发布到pypi上，我有一个项目希望依赖你的实现。
2. 我对比了kurum/kage-engine和你的仓库，说明文件中的Todo项是否有实现上的困难？如果没有，可否告诉我其逻辑在原仓库的哪里，我乐意帮助重构。
3. 我对日语和字体设计方面一窍不通，看kurum写的夹英夹日的文档很费劲，不知你能否提供一些帮助，譬如重构时的查阅的一些资料？（你提及的那份幻灯片我看了，但是比较简略，Kamichi的主页上的其他资料似乎都是日文的，感觉无从下手）

多谢！

p.s. 刚发现你是中国人，故请允许我用中文提问。

润心

[alephpi]

追问：不知你是否了解kage data format？原仓库的也没有仔细说明，我搞不懂那些magic numbers，感觉对应的是某些笔画类？

[HowardZorn]

你好，润心：

感谢您关注我的项目！

1. 不知你是否考虑发布到pypi上，我有一个项目希望依赖你的实现。

当然有，不过目前该项目还不够完善，特别是衬线体（宋体）部分，所以我考虑等到完善的时候发布。另外我有点想了解你的项目具体是需要这个repo的什么功能？

2. 我对比了kurum/kage-engine和你的仓库，说明文件中的Todo项是否有实现上的困难？如果没有，可否告诉我其逻辑在原仓库的哪里，我乐意帮助重构。

十分感谢，TODO的第一项也就是宋体部分的难点——可变偏置量的贝塞尔offset曲线（offset curves with variable displacement），这个需要复杂的2D计算机图形学知识。最简单的情况见维基百科。目前正在研读相关论文，等我工作找到了就会着手进展。原仓库的代码其实也可以用，但是其采用德卡斯特里算法采样生成多边形，而不是贝塞尔曲线，在高分辨率下比较糟糕。

3. 我对日语和字体设计方面一窍不通，看kurum写的夹英夹日的文档很费劲，不知你能否提供一些帮助，譬如重构时的查阅的一些资料？（你提及的那份幻灯片我看了，但是比较简略，Kamichi的主页上的其他资料似乎都是日文的，感觉无从下手）

追问：不知你是否了解kage data format？原仓库的也没有仔细说明，我搞不懂那些magic numbers，感觉对应的是某些笔画类？

我一开始也是一头雾水，后来直接看其论文就明白了，可能我自己本身有一些日语基础吧。这里把论文的链接贴上：https://repository.kulib.kyoto-u.ac.jp/dspace/bitstream/2433/65873/5/085-kamichi.pdf 。关键部分在论文的3.3节。如有不会我们可以直接交流，您可以发邮件（我的邮箱在我GitHub主页）给我以获取我的即时联络方式。另外，这个就是TODO的第二部分，文档的缺失。

Fw[a]rd,
8/28

[alephpi]

感谢你认真而详细的回复！

当然有，不过目前该项目还不够完善，特别是衬线体（宋体）部分，所以我考虑等到完善的时候发布。

好的，我想也是。不过你可以在包的classifier中注明early alpha。当然我不勉强，退一步说我还可以用pip install from git repo。

另外我有点想了解你的项目具体是需要这个repo的什么功能？

我的减字谱字体渲染项目需要用到kage-engine组合部件的功能。目前我用的是字统网的组字api，它也是基于kage-engine的，但是其代码不开源，对于一些复杂结构我没办法做针对性的微调。我目前还在研究kage data format如何编码各部件的相对位置，这是核心逻辑。衬线字体只是一个更贴近印刷质感的feature，无伤大雅，我原以为你只是重构了原代码的其中一部分，故有此问。目前用无衬线的黑体测试核心逻辑对我而言足够。

十分感谢，TODO的第一项也就是宋体部分的难点——可变偏置量的贝塞尔offset曲线（offset curves with variable displacement），这个需要复杂的2D计算机图形学知识。最简单的情况见维基百科。目前正在研读相关论文，等我工作找到了就会着手进展。原仓库的代码其实也可以用，但是其采用德卡斯特里算法采样生成多边形，而不是贝塞尔曲线，在高分辨率下比较糟糕。

好的。计算机图形学触及我的知识盲区了。我先看看你给的文献吧（不知为何我之前查到的版本是一份幻灯片而非论文），此外我还询问了kurgm，他发给我一个Glyph Wiki的页面（这应该也可以作为未来的文档参考），同时再结合一下代码。重构方面，我以为原代码除逻辑外也有很多值得修改的地方，譬如各种magic number完全可以用具名常量代替，还有某些变量命名也太过简略，这都妨碍了可读性，此外有些地方其实可以写得更pythonic一些。

还有一个疑问，如果需要写测试文件，由于逻辑变更，是否意味着原仓库的test不能简单移植？

最后不必客气，以你相称即可，咱们是同龄人。

顺祝找工作顺利！

润心

[HowardZorn]

好的，我想也是。不过你可以在包的classifier中注明early alpha。当然我不勉强，退一步说我还可以用pip install from git repo。

其实我并不清楚可以这样进行一个PyPI包的发行，我一直以为是要很完整的工作才可以。有空我去研究研究，应该是可行的。谢谢您的提醒。

我的减字谱字体渲染项目需要用到kage-engine组合部件的功能。

That's really cool! 希望你能够做完，我觉得是很有意思的一个事情。

目前我用的是字统网的组字api，它也是基于kage-engine的，但是其代码不开源，对于一些复杂结构我没办法做针对性的微调。

我用过，可以说它也只是针对性地做了一些微调。

我目前还在研究kage data format如何编码各部件的相对位置，这是核心逻辑。

我建议您以这个测试字符的数据（https://glyphwiki.org/wiki/twe_sandbox ）入门，包括它的一些老版本

此外我还询问了kurgm，他发给我一个Glyph Wiki的页面（这应该也可以作为未来的文档参考。

看了一眼，非常全面，比论文还全面。但是论文里的是最简单的，可能可以让你很快清楚每个magic number是干什么的。其实我主要是以它的代码和测试用例重构的。所以应该和他是完全相容的。

重构方面，我以为原代码除逻辑外也有很多值得修改的地方，譬如各种magic number完全可以用具名常量代替

我不否认，然很多专业术语并无本土中文术语或者对应英文翻译。故做这个事情可能会有一些被语言限制的地方。举个最简单的例子，宋体的小三角，在日语里叫做“ウロコ”（鱗），是鱼鳞的意思。这太难重新标准化为通用英语了。这是我个人决定保留项目中原来的一些日语罗马字写法的原因。

还有一个疑问，如果需要写测试文件，由于逻辑变更，是否意味着原仓库的test不能简单移植？

这里你说对了，原项目的测试是追求一个恒定的输出（把每个测试字符的多边形的输出固定下来了）。由于我输出的是贝塞尔曲线，我得自己手动看输出效果，所以很不一样。

顺祝找工作顺利！

谢谢！

Fw[a]rd,
8/29

[alephpi]

根据你的建议和以上提及的文档，我做了一个草样，其中宋体是kurgm的kage引擎生成的，黑体是你的实现生成的。

我注意到在笔画压缩的过程中，黑体“三”的笔画几乎粘连在一起，是否可以使笔画粗细适应缩放？但这样不同部件缩放尺度不同可能导致各部件粗细不均匀，是否有比较好的处理办法？（最笨的办法我想是直接把公共粗细调小）

[HowardZorn]

我注意到在笔画压缩的过程中，黑体“三”的笔画几乎粘连在一起，是否可以使笔画粗细适应缩放？但这样不同部件缩放尺度不同可能导致各部件粗细不均匀，是否有比较好的处理办法？（最笨的办法我想是直接把公共粗细调小）

这里的原因是，Kage引擎中黑体的代码对这种情况没有任何实际布局调整。如果您观察憂鬱等非常多笔画的商用高字重黑体，你会发现内层的笔画是有经过调整的（变细了，特别是垂直方向的）。所以目前包括我的实现在内的Kage引擎只能将全局粗细进行调节以解决这类问题，这确实有待后续加入算法进行调节。

[HowardZorn]

Dear @alephpi:

I have just released a new version of kage-python. The legacy serif stroke drawer implementation has been added to the latest commit. I hope it will be useful for your project.

Cheers,
Fw[a]rd.
12/16/2023

[alephpi]

Dear @alephpi:

I have just released a new version of kage-python. The legacy serif stroke drawer implementation has been added to the latest commit. I hope it will be useful for your project.

Cheers,
Fw[a]rd.
12/16/2023

that's awesome, I'm just about to ask you hh

[alephpi]

你好若舟，
别来无恙。

关于笔画粘连的问题，我现在打算退而求其次只使用骨架skeleton（也就是图中显示的笔画中线），然后试图使用扩散模型（比如FontDiffuser作风格迁移，相当于“神经肉质化”）。请问这个骨架应该如何获得（感觉应该是肉质化算法之前的一步）？

谢谢！

祝好，
润心

[HowardZorn]

你好，润心！

骨架可以由字形维基的数据直接获得。但是有很多很多问题，比如贝塞尔曲线不能正确画出，还有“钩”部件也是（事实上所有附属部件都会缺失）。这里建议采用极细的黑体勾画出字形的骨架。

祝你一切顺利！
Fw[a]rd.