
Loft:用纯 SVG 绘制 3D 插画和动画的 JavaScript 库
来源标题:Loft: 3D SVG Library for Web in JavaScript
Loft 是一个用纯 SVG 绘制网页 3D 插画和动画的 JavaScript 库,不依赖 Canvas、WebGL 或任何外部依赖。它基于 CAD 常用的 NURBS 曲线和曲面构建形状,输出 SVG path 元素,可随字体缩放、继承 CSS 颜色并支持服务端渲染为字符串。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
面向 Web 的 3D 插画与动画,以纯 SVG 绘制。不用 canvas,不用 WebGL,没有任何依赖。
Loft 用 NURBS(CAD 软件所用的曲线与曲面)构建形状,并将其绘制为 SVG 的 <path> 元素。因此,结果可以像文字一样缩放,颜色取自你的 CSS,能作为矢量打印,也可以在服务器上渲染成字符串。
import { Scene, shapes } from './dist/loft.js';
const scene = new Scene('#stage', { label: '一个旋转的花瓶' });
scene.add(shapes.vase(), 'clay');
scene.orbit({ auto: 0.3 });
示例
这里的每个动画都由 Loft 自身逐帧绘制成 SVG。
UI 插画(显示在顶部)。它们是界面创意的小型平面图(Loft 称之为 spot),各部分在深度上彼此分离,并在悬停时移动。
图标。来自 Lucide、Tabler Icons 和 Font Awesome 的图标,每一个都通过 kit.path() 直接从其 SVG 读取,并立起来作为一个 spot,因此其描边处于不同深度,并各自播放一小段动作:一颗心脉动,一只铃响,一个信封翻滚。
形状,每次调用生成一个,会生长、变形和旋转。Grow 动画控制一个曲面被绘制的比例;morph 将一个控制网混合成另一个以相同方式构建的控制网;rotate 旋转整个场景。
一个绑定了骨骼的 Blender 模型。六个盒子悬挂在六根骨骼上,从 .blend 文件中读出,并绘制为 1 次闭曲面,因此每一种外观都像对待花瓶那样对待它们。
在浏览器中打开 demo/index.html 即可体验所有这些内容:它加载 dist/loft.global.js,无需服务器。主页通向两个分组:UI(UI 插画,以及来自三个库的 60 个在悬停时进行 3D 移动的图标)和 Objects(形状变形、带悬停动作的形状,以及每种外观和图层下的绑定模型)。顶部的栏用于选择设计系统(Studio、Pulp、Drafting、Blueprint、Banknote 或 Print),并将其应用于每一幅绘图,而绝不应用于它们周围的页面。每一个设计系统都设定绘图在浅色和深色下的颜色(通过 --loft-ink、--loft-paper 和 --loft-accent,因此页面保留自己的颜色)、3D 形状的制作外观、UI 插画以及每个图标背后图块的线宽和圆角半径,还有动效:速度、缓动、幅度以及图片倾斜的程度。它展示了一组绘图如何呈现一个品牌。角落里的按钮在浅色、深色和系统主题之间切换。一个 sheet 的场景在首次打开时构建,地址中会指明 sheet 名称,因此 demo/index.html#model 会打开 Model sheet。
示例
安装
工作原理
制作形状
外观与材质
场景
动效
UI 插画
内置内容
主题化
渲染为字符串
<loft-scene> 元素
数学原理
限制
开发
安装
该包未发布到 npm。请使用 dist/ 中的构建文件:
TypeScript 定义在 types/index.d.ts 中。
曲面存储为一个小型的控制点、权重和两个节点向量的网格。
每一帧都将曲面采样为一个点网格。基函数只制表一次,因此之后移动控制点开销很小。
每个网格单元都会被着色;当它跨越多个色调时,会沿色调等值线切开,使着色边缘平滑。
面片、线条和点按从远到近排序(SVG 没有深度缓冲),具有相同样式的相邻元素会合并为一个 <path>。
路径在帧之间复用;只有它们的 d 和 class 属性会变化。
制作形状
每个构造函数都返回一个 NurbsCurve 或 NurbsSurface。角度以弧度为单位。Y 轴向上。
| 调用 | 生成 |
|---|---|
| line(a, b) | 一条直线段 |
| polyline(points, { closed }) | 带有尖角的直线段 |
| curve(points, { degree, closed, weights }) | 向其控制点拉伸的 B 样条 |
| interpolate(points, { degree }) | 穿过每个点的平滑曲线 |
| arc({ center, radius, start, end }) | 精确的圆弧或椭圆弧 |
| circle({ radius, center, normal }) | 精确的圆 |
| joinCurves([a, b, …]) | 由首尾相接的片段组成的一条曲线 |
曲面
| 调用 | 生成 |
|---|---|
| revolve(profile, { axis, angle }) | 轮廓绕轴旋转:花瓶、碗、穹顶 |
| sweep(profile, path, { scale, twist }) | 轮廓沿路径移动:号角、丝带 |
| tube(path, { radius }) | 沿路径的圆管 |
| loft(sections, { degree, interpolate, closed }) | 一排截面曲线上的蒙皮 |
| extrude(profile, vector) | 沿直线方向挤出的轮廓 |
| ruled(a, b) | 两条曲线之间的直线 |
| surface(grid, { closedU, closedV }) | 由控制点网格构成的曲面 |
| plane, sphere, torus, cylinder, cone, capsule | 常见精确实体 |
shapes 包含现成的起点:vase、knot、shell、blob、ribbon、sheet、hull。
import { interpolate, line, joinCurves, revolve } from './dist/loft.js';
// 一个高脚杯:先是一个平底,然后是一个穿过四个点的平滑杯身。
const body = interpolate([[0.5, -1, 0], [0.1, -0.4, 0], [0.6, 0.4, 0], [0.5, 1, 0]]);
const goblet = revolve(joinCurves([line([0, -1, 0], [0.5, -1, 0]), body]));
编辑
surface.setPoint(i, j, [x, y, z]); // 移动一个控制点
surface.setWeight(i, j, 2.5); // 使其拉力更强
surface.point(u, v); // 曲面上的一个点
surface.normal(u, v); // 其单位法线
surface.isoCurve('u', 0.5); // u 固定处的曲线
surface.transform(math.scaling(2)); // 变换后的副本
保形操作:insertKnot、refineCurve、refineSurface、subcurve、splitCurve、toBezier、elevateDegree、makeCompatible。
一个材质最多有四层。一个外观是这些层的调校组合。
scene.add(surface, 'ink'); // 按名称使用外观
scene.add(surface, { look: 'clay', color: '#2f6f8f' }); // 修改颜色的外观
scene.add(surface, { look: 'ink', lines: { u: 16, v: 0 } }); // 调整了一层的的外观
scene.add(surface, { // 自定义图层
fill: { color: 'accent', tones: 4 },
lines: { u: 12, v: 8, color: 'ink', width: 0.6, hidden: 'dashed' },
outline: { width: 1.5, crease: 40 },
dots: false,
});
| 层 | 选项 |
|---|---|
| fill |
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。