Khatt:阿拉伯文动画书法 是做什么的?
Khatt 使用 HarBuz 对文本进行塑形(连字、从右向左排列、标记定位), 将文本布局并利用纯 CSS 在单个 SVG 文件中实现动画效果。无需网络,无需安装: 脚本、字体和塑形引擎都位于此文件夹中。
创建绘图
node scripts/khatt.mjs "النص" --style ruqaa --layout line --effect ink -o out.svg
从本技能文件夹运行,或使用 scripts/khatt.mjs 的完整路径。
将输出文件写入用户指定的位置(如项目文件夹、桌面等)。
| 选项 | 值 |
|---|---|
--style | ruqaa(日常斜体)、naskh(经典书体)、kufi(角形)、nastaliq(波斯悬垂体)、kano(粗笔触)、blaka(粗体几何) |
--layout | line、arc、circle(环形带星)、mirror(经典镜像 musanna) |
--effect | ink、gold、bleed、mosaic、sand、neon、stars、lantern、rise、stamp、reveal、wave,或 .mjs 效果文件路径 |
--palette | paper、night、neon、zellige、desert、clear(透明) |
--ink、--accent、--bg | 覆盖颜色,例如 --ink "#0b3d2e" --bg none |
--still | 冻结在完成绘图上(适用于标志和印刷) |
-o | .svg 生成文件本身,.html 生成页面(点击重播) |
运行 node scripts/khatt.mjs --list 查看所有选项及简要说明。
在文本中使用 \n 表示换行(最多四行)。
选择建议
- 人名和英文单词: Khatt 仅绘制阿拉伯文字符。请先音译(Sara → سارة、Kamangir → كمنجير),当拼写有多种可能时, 在渲染前向用户展示你所用的拼写。
- 斋月或开斋节: 使用
lantern或gold配合night,风格naskh或ruqaa。 - 婚礼和正式卡片: 使用
gold、rise或ink;尝试--layout mirror。 - 标志: 使用
--still,风格kufi或blaka,--palette clear。 - 社交媒体帖子: 动画
.svg可在任何浏览器中播放。如需视频, 请引导用户访问工作室(https://m-alkassem.github.io/khatt/),它支持导出 MP4。 - 短文本效果最佳。长句子:使用
line布局,两到三行。
如果可能,请为用户打开结果文件(例如 macOS 上运行 open out.html)。
创建新效果
当现有十二种效果都不适用时(例如“让字母燃烧”、“一个摇摆的斋月灯笼”),可以编写新效果。
从 examples/ripple.mjs 开始。一个效果是一个不带导入的普通对象:
export default {
id: "my-effect", name: "My effect", nameAr: "…", blurb: "…",
palette: "night", // 默认调色板 ID
loop: false, // 如果持续运动则为 true
render(ctx) {
// 返回 { css, defs?, body, duration, poster? }
},
};
render(ctx) 接收:
ctx.pieces:每个字形的条目:d(SVG 路径)、order(阅读顺序,0 = 第一个 字母)、box{x0,y0,x1,y1}、cx、cy。镜像副本共享相同的 order。ctx.steps、ctx.box(文本框)、ctx.view(整个画布)、ctx.em(字体大小,100)、ctx.palette(bg、ink、accent)、ctx.rng()(种子随机数)。ctx.stagger(order, spread?):字母的延迟,在spread秒内分布。ctx.sample(piece, count):字母内部的随机点,用于粒子效果。ctx.inside(piece, x, y)、ctx.area(piece)。ctx.anim(name, seconds, { ease, loop, alternate }):为某个类生成动画 CSS。ctx.at(seconds, extraStyle?):设置元素延迟的内联样式。ctx.n(number):四舍五入数字以生成紧凑输出。ctx.p:唯一前缀。用于每个类、ID 和关键帧名称。
保持绘图在任意帧可暂停的规则(静态图像和视频导出依赖于此规则):
- 每个动画元素都有
class="${p}-a ..."和style="${at(seconds)}"。 - 在类规则中使用
ctx.anim(...)。永远不要自己写animation:简写形式 或设置animation-delay。 - 命名关键帧为
${p}-something。如需将元素围绕其中心缩放或旋转, 添加${p}-b类。 - 仅动画化 CSS 属性(
opacity、transform、stroke-dashoffset、fill-opacity等)。SMIL<animate>和脚本无法正确冻结。 - 保持轻量:最多几千个元素。
然后运行:
node scripts/khatt.mjs "نار" --effect ./my-effect.mjs -o fire.html
如果用户喜欢,建议他们将其作为拉取请求提交到
https://github.com/M-Alkassem/khatt(效果文件位于 src/effects/)。