Florilegium:用 LaTeX 生成程序化花卉

Hacker News Top 工具

摘要

Florilegium 是一个开源 LaTeX 宏包,能够程序化生成青花瓷风格的花卉页边装饰。每一片花瓣、叶子和茎秆都以参数化曲线在 Lua 中计算,并直接绘制到 PDF 中。它既提供手工设计的构图,也提供能够自适应文档布局的'生长式'满铺构图,还支持动画生长渲染以及响应文本的装饰性首字母等特性。

暂无内容
查看原文
查看缓存全文

缓存时间: 2026/10/30 18:13

kevinraymond/florilegium

来源:https://github.com/kevinraymond/florilegium

florilegium

起源

那篇 Reddit 帖子(https://www.reddit.com/r/LaTeX/comments/1xixznw/how_do_you_make_these_flowers_in_latex/)询问如何在 LaTeX 中制作这样的花卉图案。我不知道原作是如何制作的,本项目也不试图复现它。这只是一种可能的方式,也是我实现它的方式:手工编写带随机化参数的图元,用 Lua 绘制,通过程序化布局进行放置,其中“填补空白“的部分借鉴了 1998 年装饰艺术文献中的一个想法。效果与之相似。

这是什么

为 LaTeX 程序化生成的代尔夫特蓝花卉页边装饰。没有图片、没有导入路径、没有外部资源:每一片花瓣、叶子和茎干都是在 Lua 中于排版页面时实时计算的参数曲线,像水彩一样绘制,直接写入 PDF。每一页都有属于自己的花园。

六颗种子(six seeds) 同一段代码,不同的种子——花园会填满文字留下的任何空余空间。

两个文档共用一个宏包,第三个文档展示它还能做什么:

florilegium.texflorilegium-grow.tex
构图方式手工创作:茎、叶和花由手工放置,每个参数均经过采样生长式:一棵植物通过贪心空间填充循环生长以适应页面
适应对象无(针对 A4 纸、68mm 页边距调校)页面布局,以及最后一页文字下方的空白空间
预览

两份 PDF 都是自述性的:正文即是对页边装饰绘制方式的说明。

生长式文档的最后一页:文字提前结束,枝条便拱入下方的空白空间。

300 dpi 局部特写。斑驳的晕染中以白色提亮出条纹,带有白色叶脉的裂叶,勿忘我聚伞花序,茎干后方一朵淡淡的幽灵之花。

观看它生长

生长过程它填充的空余空间

种子 6,从空白页边到完成的页面。茎干先向上生长,当叶尖通过节点时叶片展开,每根茎干末端开出一朵花。然后贪心循环接管:右侧每个虚线圆是它找到的最大空闲圆盘,就在一根枝条生长到它之前。大的空洞先处理且速度慢,小的最后处理且速度快。蝴蝶和蜜蜂飞入,小鸟滑落到自己的枝条上,蜗牛爬上茎干,直到最后一帧——这正是这颗种子每次产生的页面。

生长过程在页面排版时被记录一次:每根茎干同时以递增长度的前缀绘制,每个图元以几个较小的缩放比例绘制,重放相同的随机抽样。每一帧写出当时已到时间的部分,保持原始的绘画顺序。

make grow-6 以此方式渲染一个种子(build/grow-6.gif 和 .mp4,约 45 秒);添加 EXPLAIN=1 显示虚线圆。

页边装饰会阅读文字

showcase.tex,“页边的一年”:第一页是春天,夏天,最后一页是秋天。每个章节描述它所展示的特性。

生长式页边装饰可以响应周围文档:

  • 首字母花饰。 \florilegiuminitial[5]{E} 将段落首字母设置在五行高的装饰框中。字母轮廓从 OpenType 字体读取(默认为 Latin Modern Bold),像花瓣一样绘制;一条藤蔓交替穿过它的笔画上下,在合适的地方长出叶子,在空隙处开出花——通常在字母的封闭空间(counter)中。该字母同时被不可见地排版,所以段落复制出来仍然是“Every“。
  • 标题处的花朵。 使用 sections 选项时,每个带编号的节和小节标题旁的页边都会得到一朵花,以强调色的铜色绘制——正如过去标题曾以红色点缀。
  • 文字指定处的花朵。 \florilegiumbloom 在它所在的行旁放一朵花;\florilegiumbloom[lily] 可请求花园中的任意图元。标记在页面送出时在页面盒(page box)中被找到,因此一次编译即可生效。
  • 季节。 使用 aging 选项时,花园从第一页的春天(大多还是花苞,小而淡的叶子)到最后一页的秋天(种荚,飘落的花瓣,几片铜色的叶子)逐渐成熟。这需要两遍编译以获取总页数;也可以用 \florilegiumage{0.8} 手动设定年龄。

一个种子经历春夏秋冬:季节改变的是长出什么,而不是长在哪里。

访客

带小鸟和蜗牛的局部特写

大多数页面都有访客:开阔空间中一两只蝴蝶和蜜蜂,蜗牛爬上一根主茎,大约每五页有一只小鸟栖息在自己的枝条上。它们来自独立的随机流,所以没有它们的页面与原来完全一样;novisitors 选项可将它们排除。

任意墨色

一个种子,六种墨色

整个配色来自一个颜色 ink:代尔夫特蓝、乌贼墨、绿色、深红、紫色、青色。从最深的笔触到最淡的晕染的色阶从该色相在 OKLCH 色彩空间中计算,所以浅色端不会变灰。

用 PostScript 实现

postscript/florilegium.ps 的两页,种子 7

postscript/florilegium.ps:纯 PostScript 实现的生长式页边装饰,一个自包含文件。Ghostscript 或打印机在解释页面时计算每片花瓣,两页文字解释了它是如何做到的。

绘图核心、每个图元和生长循环都是从 ink.lua、flora.lua 和 grow.lua 逐过程移植的。不需要 TeX 或其他文件:

sh gs -dALLOWPSTRANSPARENCY -sDEVICE=pdfwrite -dSeed=7 -o garden.pdf postscript/florilegium.ps
make postscript # 同样的结果 -> build/postscript-7.pdf; SEED=12 可换花园

-dSeed=N 选择花园;不指定则由时钟选择,所以每次打印都是新的。-dAge=0 到 1 设置季节,-dNoVisitors 排除蝴蝶、蜜蜂、蜗牛和小鸟。两页大约需要 2.5 秒。

大部分 Lua 可以直接映射:PostScript 自身的变换矩阵放置每个图元(平移、旋转、缩放),路径和贝塞尔曲线是原生的,运行时构建的过程(procedure)替代了 Lua 的闭包(一片花瓣的半宽是一个传给轮廓构建器的过程)。有四样东西不能直接映射:

  • 图层。 花园按一个顺序生长,但需要从后向前绘制,因此每个填充和描边都通过 pathforall 捕获到每层的列表中,最后回放。
  • 透明度。 PostScript 没有透明度。Ghostscript 通过 -dALLOWPSTRANSPARENCY 提供支持。没有该标志,或在打印机上,每个半透明填充会与其可能落底的颜色混合后不透明绘制。结果更平,但仍是同一个花园。
  • 随机性。 生成器是 32 位整数运算的 Park-Miller 伪随机数,而 PostScript 实数是单精度的,所以这里的种子 7 与 LaTeX 中的种子 7 是不同的花园。
  • 文字。 该文件用 Times 排版自己的两页。它知道标题在哪里以及文字在哪里结束,所以标题处的铜色花朵和最后一行下方的花园与 LaTeX 中效果一致。它没有首字母花饰、动画或手工构图。

同一文件用 lp postscript/florilegium.ps 两次发送到一台 Epson 喷墨打印机,未指定种子。计算机的打印系统为每个任务重新运行程序,所以每次打印从时钟获取种子,长出不同的花园。打印机得到的是不透明版本,因为它没有透明度支持。

构建

LuaLaTeX,单遍编译,每页约一秒(showcase.tex 需要两遍,因为季节需要总页数)。

sh make # 三个 PDF
make seed-7 # 种子 7 的一页 -> build/seed-7.pdf
make gallery # gallery/seeds.png + seeds.gif, inks.png, seasons.png (python3, Pillow, pdftoppm)
make grow-6 # 种子 6 的生长动画 -> build/grow-6.gif + .mp4 (ffmpeg)
make grow-6 EXPLAIN=1 # 同上,标注空闲圆盘 -> build/grow-6-explain.*

没有安装 TeX?构建一次镜像,然后在其中运行一切:

sh docker build -t florilegium-tex tools
make RUN=tools/in-docker

或者将 florilegium.sty、六个 .lua 文件和一个 .tex 文件粘贴到 Overleaf(https://www.overleaf.com)项目中,将编译器设为 LuaLaTeX。

在自己的文档中使用:

\usepackage[grown]{florilegium}
% 或者手工创作版:\usepackage{florilegium}
% 生长式选项:sections(标题处花朵),aging(需要两遍编译),
% novisitors(不要蝴蝶、蜜蜂、蜗牛和小鸟)
\definecolor{ink}{HTML}{5B2A1F} % 可选:整个配色的色相(这是乌贼墨色)
\definecolor{accent}{HTML}{B4662F} % 可选:细线的铜色
...
\florilegiuminitial[4]{T}his paragraph starts with a decorated T.
...
a flower in the margin beside this line\florilegiumbloom
...
\florilegiumage{0.8} % 仅生长式:从这里开始是秋天
\florilegiumtextend % 仅生长式:放在文字的最末尾

使用固定种子代替页码:lualatex "\def\florilegiumseed{7}\input{florilegium-grow.tex}"。

任何图元都可以单独在 TikZ 图片中绘制,遵循当前作用域的位移、旋转和缩放:

\begin{tikzpicture}
  \begin{scope}[shift={(2,2)},rotate=20]\florilegiumdraw{flower}{1.3}\end{scope}
  \begin{scope}[shift={(5,0)}]\florilegiumdraw{leaf}{3.0, {depth=0.6}}\end{scope}
  \begin{scope}[shift={(8,1)}]\florilegiumdraw{ghost}{"lily", {s=1.4}}\end{scope}
  \begin{scope}[shift={(11,1)}]\florilegiumdraw{butterfly}{1.5}\end{scope}
\end{tikzpicture}

工作原理

绘制(ink.lua)。所有几何计算在 Lua 中完成,以 PDF 路径操作符写入每页的一个文字节点;TeX 不做任何算术运算。图元在仿射变换下的局部坐标系中绘制,当在作用域内调用图元时,从 TikZ 读取该变换。颜色来自从文档颜色 ink 派生的色调渐变:从 ink 色相的海军蓝到薄雾色,在 OKLCH 中插值,确保浅色端保持蓝色而非变灰。锥形笔画由两条偏移的贝塞尔曲线组成,而非采样条带。

图元(flora.lua)。按照水彩画家的顺序绘制:先平涂一层色,再以正片叠底方式叠加深色斑块,边缘处颜料聚积,以白色提亮出条纹,几条纤细叶脉,几乎没有轮廓线。宽大花瓣和花朵,倾斜视角的星形百合,花簇和小花,花苞和钟形花;裂叶和全缘叶;像蝎尾一样卷曲的勿忘我聚伞花序,分叉小枝,伞形花序,卷须,种荚;蝴蝶、蜜蜂、蜗牛和小鸟;铜色星点、玫瑰花饰和常春藤叶形花饰——其茎干化为页脚分隔线。任何一个都可以作为淡淡的幽灵之花绘制。

手工构图(authored.lua)。一株植物从左下角的根部生长:三根茎干经过手工选取的控制点,第四根沿页面底部作为页脚,叶子放在茎干的选定比例处,所有其他图元放在一根从茎干切向离开、沿图元自身轴线到达的枝条上——所以每朵花都可以追溯回根部。

生长式构图(grow.lua),秉承 Wong、Zongker 与 Salesin 的 Computer-Generated Floral Ornament(https://dl.acm.org/doi/10.1145/280814.280948)(SIGGRAPH 1998)的精神。茎干在文本栏中以其高度为标度的平滑噪声蜿蜒上升;叶子在有空间的节点处悬挂。然后反复执行:取茎干可达范围内最大的空闲圆盘,选择适合它的图元,从最近的茎干点生长一根枝条过去;该枝条又成为茎干。大的空洞先被取用,所以花朵和百合早早出现,花束和叶子填充中间,最后循环将小叶、花苞和小花塞到茎干上。文字结尾通过 \pagetotal 在同一遍编译中测量,所以较短的最后一页会用一次编译将枝条生长到下方的空间。

阅读页面(florilegium.lua)。标题或 \florilegiumbloom 在文本中留下一个不可见的标记节点。页面送出时,遍历其盒子逐节点累加高度、深度和实际排版的弹性间距,找到每个标记在页面上的高度;花园在任何叶子悬挂之前就为这些行送上花朵。年龄会重新分配图元的权重:春天是花苞和花苞枝,秋天是种荚,某些叶子用强调色而非墨色构建的色阶绘制。

首字母花饰(initial.lua)。字母轮廓从 luaotfload 的 OpenType 读取器以贝塞尔线段形式获取。展平为多边形后可进行奇偶规则的内部测试,一张与字母和边框的距离网格找出花朵可用的最大空隙。藤蔓是一条穿过装饰框的 Catmull-Rom 曲线;与字母相交时交替从上下穿过,位于上方的笔段在字母内部以纸色细光晕重新绘制。

程序化 ≠ 随机。 种子由页码推导,所以第 n 页总是得到花园 n。可复现性是文档能够稳定排版的关键。参见 CLAUDE.md 获取代码地图、可调参数和未完成的想法。

许可证

MIT。

相似文章

使用LaTeX的复古科学论文

Hacker News Top

这是一个GitHub仓库,提供20个独立的LaTeX示例,用于创建复古科学论文的美学效果,其中整合了MetaPost和LuaTeX进行图形和排版。

FLOORA:一个与人类对齐、面向建筑设计的领域专用语言模型

arXiv cs.LG

Autodesk Research 推出了 FLOORA——一系列用于建筑布局生成的小型领域专用语言模型,其核心是使用一种自定义的领域特定语言(DSL)。其中 0.6B 参数的模型在面对分布外的建筑案例时,表现优于体量大得多的前沿模型,VLM 评审胜率最高可达 92%。

TALA 现已开源

Hacker News Top

TALA, Terrastruct 的自动布局算法,现已采用 MPL-2.0 许可证开源,并与 D2 v0.9.0 捆绑发布,为创建美观的软件架构图提供了一种新颖的方法。