返回资讯中心
外部精选
软件工程
#开发者实时流

Loft:用纯 SVG 绘制 3D 插画和动画的 JavaScript 库

来源标题:Loft: 3D SVG Library for Web in JavaScript

Loft 是一个用纯 SVG 绘制网页 3D 插画和动画的 JavaScript 库,不依赖 Canvas、WebGL 或任何外部依赖。它基于 CAD 常用的 NURBS 曲线和曲面构建形状,输出 SVG path 元素,可随字体缩放、继承 CSS 颜色并支持服务端渲染为字符串。

Hacker News 最新uxmatthewc2026/11/16 · 昨天30 分钟阅读

以下正文由 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 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →