Two.js 核心入口类 Two 全解析:从实例化、渲染类型到场景构建与图形工厂方法
Two.js 核心入口类 Two 全解析:从实例化、渲染类型到场景构建与图形工厂方法
导读
Two 类是 Two.js 的入口点(entrypoint):通过 new Two 实例化即可搭建一个可渲染的场景,同时 Two 也是整个库对外暴露的全局命名空间,所有子类、函数与工具函数都挂载其上。本文以仓库中的官方 API 文档 wiki/docs/two/README.md 为骨架,结合 src/two.js 与 src/constants.js 的实现源码、以及 tests/suite/ 下的测试用例,系统讲解 Two 的构造函数选项、静态常量、实例属性与全部 make* 图形工厂方法、SVG 解释/加载流程与动画循环机制。读完本文,你将能独立完成一个 Two.js 场景的搭建、图形绘制、动画控制、命中检测与 SVG 导入。
一、认识 Two:入口点与全局命名空间
Two 继承了 Two.Events(事件系统),因此实例天然具备 bind/unbind、trigger 等事件能力。正如文档所述:
The entrypoint for Two.js. Instantiate a
new Twoin order to setup a scene to render to.Twois also the publicly accessible namespace that all other sub-classes, functions, and utilities attach to.
从源码 src/two.js 可见,类内部通过 _events = new Events() 持有事件对象,并对外暴露了 on/bind/addEventListener、off/unbind/removeEventListener、trigger/dispatchEvent 等别名方法(src/two.js#L102-L131),保证与浏览器事件接口习惯的兼容性。
同时,Two 作为命名空间在 src/two.js#L328-L375 上挂载了全部核心类与工具:Two.Anchor、Two.Collection、Two.Group、Two.Matrix、Two.Path、Two.Text、Two.Vector,效果类 Two.Gradient、Two.Image、Two.ImageSequence、Two.LinearGradient、Two.RadialGradient、Two.Sprite、Two.Stop、Two.Texture,基础形状 Two.ArcSegment、Two.Circle、Two.Ellipse、Two.Line、Two.Points、Two.Polygon、Two.Rectangle、Two.RoundedRectangle、Two.Star,以及三种渲染器 Two.CanvasRenderer、Two.SVGRenderer、Two.WebGLRenderer。这意味着你既可以 new Two() 创建场景,也可以直接用 new Two.Circle(...)、new Two.Path(...) 等构造对象。
二、构造函数与实例化选项
构造函数签名
new Two(options)
文档给出的 options 参数表如下:
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
options.fullscreen |
Boolean | false |
设为 true 时,舞台自动适配父级文档(document)的宽高;此参数会覆盖 width/height,同时覆盖 options.fitted |
options.fitted |
Boolean | false |
设为 true 时,舞台自动适配父元素的宽高;此参数会覆盖 width/height |
options.width |
Number | 640 |
构造时舞台的宽度,可在之后通过 two.width 修改 |
options.height |
Number | 480 |
构造时舞台的高度,可在之后通过 two.height 修改 |
options.type |
String | Two.Types.svg |
渲染器类型,可选值见下文 Two.Types |
options.autostart |
Boolean | false |
设为 true 时,实例自动通过 requestAnimationFrame 进入绘制循环,等价于调用 Two.play() |
options.domElement |
Element | — | 要绘制进其中的 canvas 或 SVG 元素;当元素类型与 type 不匹配时,它会覆盖 options.type |
这些默认值在源码构造函数中有明确对应(src/two.js#L184-L191):
const params = _.defaults(options || {}, {
fullscreen: false,
fitted: false,
width: 640,
height: 480,
type: Two.Types.svg,
autostart: false,
});
渲染器类型解析逻辑
构造函数会先按默认值补齐参数,随后处理 domElement 的覆盖逻辑(src/two.js#L204-L215):当传入的 domElement 是 DOM 元素时,会比对 this.type 与元素 tagName 的组合是否属于 CanvasRenderer-canvas、WebGLRenderer-canvas、SVGRenderer-svg 三者之一;若不一致,则根据元素标签名将 type 重置为 Two.Types[tagName]。例如你传入一个 <svg> 元素但声明 type: 'canvas',Two.js 会将其纠正为 SVG 渲染器。
紧接着:
this.renderer = new Twothis.type;
this.setPlaying(params.autostart);
即用字符串形式的 type 动态实例化对应的渲染器类。最后实例被 Two.Instances.push(this) 注册进全局实例列表,若 autostart 为真则启动 raf.init() 动画循环(src/two.js#L264-L271)。
三种典型实例化方式
全屏自适应(最简起步,来自仓库 README.md 的官方 boilerplate):
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<script src="js/two.min.js"></script>
</head>
<body>
<script>
var two = new Two({
fullscreen: true,
autostart: true
}).appendTo(document.body);
var rect = two.makeRectangle(two.width / 2, two.height / 2, 50, 50);
two.bind('update', function() {
rect.rotation += 0.001;
});
</script>
</body>
</html>
指定尺寸与渲染器:
const two = new Two({
width: 800,
height: 600,
type: Two.Types.webgl, // 'WebGLRenderer'
}).appendTo(document.body);
挂载到已有 DOM 元素(domElement 优先于 type):
const canvas = document.getElementById('my-canvas');
const two = new Two({
width: 800,
height: 600,
domElement: canvas, // 传入 canvas 时自动采用 CanvasRenderer 或 WebGLRenderer
});
三、静态成员与常量
Two 上定义的静态常量多数直接引用 src/constants.js 中的 Constants 对象(src/two.js#L273-L319)。
Two.Types —— 渲染器类型字典
The different rendering types available in the library.
Types: {
webgl: 'WebGLRenderer',
svg: 'SVGRenderer',
canvas: 'CanvasRenderer',
}
对应源码在 src/constants.js#L17-L21。这是「渲染器无关(renderer agnostic)」设计的核心:同一套 API 可分别绘制到 WebGL、Canvas2D 与 SVG 三种上下文。构造函数中正是用 new Twothis.type 动态选择渲染器实现。
Two.Version 与 Two.PublishDate
Two.Version:库当前版本字符串,构建时由Constants.Version注入('<%= version %>'模板)。Two.PublishDate:构建流程自动生成的发布日期,用于验证版本候选。
Two.Identifier —— 对象 id 前缀
String prefix for all Two.js object's ids. This trickles down to SVG ids.
值为 'two-'(src/constants.js#L39),所有 Two.js 对象的 id 均以该前缀开始,并会传导到 SVG 元素的 id 上,方便 DOM 侧定位。
Two.Resolution —— 弧线采样分辨率
Default amount of vertices to be used for interpreting Arcs and ArcSegments.
值为 12(src/constants.js#L45)。这是解释 Arc 与 ArcSegment 时的默认顶点数量,数值越大曲线越平滑、顶点越多。
Two.AutoCalculateImportedMatrices —— SVG 导入矩阵计算开关
When importing SVGs through the
Two.interpretandTwo.load, this boolean determines whether Two.js infers and then overrides the exact transformation matrix of the reference SVG.
默认值为 true(src/constants.js#L52)。文档特别提示:
falsecopies the exact transformation matrix values, but also sets the path'smatrix.manual = true.
即:设为 true 时 Two.js 自行推断并覆盖参考 SVG 的精确变换矩阵;设为 false 时则原样拷贝矩阵值,但同时会把路径的 matrix.manual 置为 true,意味着后续不再自动计算矩阵,需手动维护。
Two.Instances —— 实例注册表
Registered list of all Two.js instances in the current session.
默认空数组(src/constants.js#L58)。每次 new Two() 都会 push 自己。全局动画循环正是遍历该列表实现的:
function loop() {
for (let i = 0; i < Two.Instances.length; i++) {
const t = Two.Instances[i];
if (t.playing) {
t.update();
}
}
Two.NextFrameId = raf(loop);
}
(见 src/two.js#L1262-L1271)这解释了为何多个 Two.js 实例共享同一个 requestAnimationFrame 驱动。
Two.uniqueId —— 自增 id 分配器
静态函数,返回一个不断递增的 Number:
uniqueId: function () {
return count++;
}
(src/constants.js#L65-L67)用于所有 Two.js 对象的 id 分配。
Two.Commands —— 路径命令映射
Map of possible path commands. Taken from the SVG specification. Commands include:
move,line,curve,arc, andclose.
来自 src/utils/path-commands.js,源自 SVG 规范。构造路径顶点时即为每个 Anchor 指定命令类型(见下文 makeArrow 实现中 Commands.move、Commands.line 的使用)。
Two.Utils —— 工具函数集合
A massive object filled with utility functions and properties.
在 src/two.js#L59-L70 中通过 _.extend 聚合而成,包含:
Two.Utils.Error:错误类型TwoError;Two.Utils.getRatio:来自 src/utils/device-pixel-ratio.js 的像素比计算;Two.Utils.read:按元素名索引的 SVG 解析函数集合,其中Two.Utils.read.path用于解析 SVG<path>元素或d属性字符串(见 src/utils/interpret-svg.js);Two.Utils.xhr:异步加载工具;- 以及
_(underscore 工具)、CanvasPolyfill、Curves、math等展开内容。
四、实例成员属性
| 属性 | 类型 | 说明 |
|---|---|---|
two.type |
String | 实例所实例化的渲染器类型字符串(如 'SVGRenderer'),默认 '',构造时赋值 |
two.renderer |
Object | 实例的渲染器实例,可选类型见 Two.Types |
two.scene |
Two.Group | 场景根 Two.Group,容纳实例的所有对象;因为它是一个 Group,可以对其施加变换从而影响全部对象,适合当作「反转的相机」使用 |
two.width |
Number | 实例 DOM 元素的宽度 |
two.height |
Number | 实例 DOM 元素的高度 |
two.frameCount |
Number | 已流逝的帧数(整数) |
two.timeDelta |
Number | 距上一帧流逝的时间(毫秒) |
two.playing |
Boolean | 是否正在通过自动的 requestAnimationFrame 更新 |
这些属性在 src/two.js#L133-L179 中均有对应字段声明。其中 scene 在构造函数末尾被赋值为 this.renderer.scene(src/two.js#L265),即渲染器持有的根 Group。
五、实例方法:生命周期与场景管理
fit()
仅当构造时传入 fullscreen 或 fitted 才会创建该方法。它根据传入的选项,把实例的 width/height 设置为对应父级(window 或父元素)的尺寸。源码中的 fitToWindow 与 fitToParent(src/two.js#L1229-L1250)分别读取 document.body.getBoundingClientRect() 与 renderer.domElement.parentElement.getBoundingClientRect(),并调用 renderer.setSize(width, height, this.ratio)。fullscreen 模式下还会同步修改 body 与舞台元素的样式(去边距、position: fixed),并绑定窗口 resize 事件(src/two.js#L226-L249)。
appendTo(elem)
将 Two.js 舞台快捷挂载到指定 DOM 元素:
two.appendTo(document.body); // 返回 this,支持链式调用
实现为 elem.appendChild(this.renderer.domElement);若实例处于 fit 模式且目标不是 window,还会把 resize 监听绑定到新父元素并立即 update()(src/two.js#L383-L395)。
play() 与 pause()
play():启动内部动画循环,将playing置为true并触发event:play。注意:它发起的是一个requestAnimationFrame循环(全局raf.init(),见 src/two.js#L1260-L1276)。pause():停止该实例的动画循环,触发event:pause。
two.play(); // 开始
two.pause(); // 暂停
release(obj)
Release a Two.Element’s events from memory and recurse through its children, effects, and/or vertices.
释放某个 Two.Element 的事件监听并从内存中解除,同时递归遍历其子元素、效果与顶点;不传参时默认释放根 Two.Group(即 scene)。返回传入的对象。
源码实现(src/two.js#L432-L535)完整展示了清理层级:
- 对对象调用
unbind()解除事件; - 解除
fill、stroke上挂载的效果(如 Gradient)的监听; - 递归
vertices,逐个解除顶点与其左右控制点(controls.left/controls.right)的监听; - 递归
children并解除集合监听; - 清理渲染器资源:SVG 中移除对应 DOM 节点、WebGL 中删除
texture与positionBuffer、Canvas 中清理缓存上下文。
getShapesAtPoint(x, y, options)
返回指定世界坐标系(与渲染输出一致的坐标空间)下的图形列表,从前到后排列,即 Array.<Two.Shape>。命中测试配置项:
| 参数 | 说明 |
|---|---|
options.visibleOnly |
仅返回可见图形 |
options.includeGroups |
命中结果中包含组 |
options.mode |
返回所有相交图形还是仅最顶层图形('all' / 'deepest') |
options.deepest |
mode: 'deepest' 的别名 |
options.precision |
曲线几何的细分精度 |
options.tolerance |
命中测试的像素容差 |
options.fill |
覆盖填充命中测试行为 |
options.stroke |
覆盖描边命中测试行为 |
options.filter |
用于从结果集中过滤图形的谓词函数 |
文档提示:该方法委托给根场景的 Two.Group.getShapesAtPoint。源码印证(src/two.js#L556-L561):
getShapesAtPoint(x, y, options) {
if (this.scene && typeof this.scene.getShapesAtPoint === 'function') {
return this.scene.getShapesAtPoint(x, y, options);
}
return [];
}
仓库测试 tests/suite/hit-test.js 对该 API 的行为做了验证:two.getShapesAtPoint(100, 100) 与 two.scene.getShapesAtPoint(100, 100) 结果一致;{ mode: 'deepest' } 只返回最顶层图形;{ visibleOnly: false } 会把隐藏图形也纳入结果集。
update() 与 render()
update():渲染前一次性更新位置与计算,再绘制到画布;触发event:update,并传入frameCount与timeDelta。使用Two.play()或构造时autostart: true会自动调用它。render():渲染场景中所有可绘制且可见的对象;触发event:render,并递增frameCount。
two.update(); // 手动更新+渲染一帧
two.render(); // 仅渲染
从源码可见,update() 内部会计算 timeDelta(基于 performance.now())、在 fit 模式下同步尺寸、在尺寸变化时调用 renderer.setSize(width, height, this.ratio),最后 trigger(update) 再 return this.render()(src/two.js#L570-L597)。
add()、remove() 与 clear()
add(objects):把 Two.js 对象加入场景的快捷方法,支持传入数组,也支持逐个传入多个参数。remove(objects):把对象从场景移除的快捷方法。clear():移除场景中的全部对象。文档特别提醒:若希望浏览器进行垃圾回收,应用层还需要删除自身的引用。
two.add(rect, circle); // 逐个参数
two.remove([rect]); // 数组形式
two.clear(); // 清空场景
实现分别委托给 this.scene.add(...)、this.scene.remove(...) 与 this.scene.remove(this.scene.children)(src/two.js#L618-L651)。
六、图形工厂方法 make*:一行代码绘制各种形状
所有 make* 方法的共同行为是:创建对应对象并立即加入当前实例的 scene,然后返回该对象(源码中统一为 this.scene.add(obj); return obj; 模式)。这也意味着构造后无需再手动 two.add()。
线与箭头
makeLine(x1, y1, x2, y2) → Two.Line
const line = two.makeLine(0, 0, 100, 100);
makeArrow(x1, y1, x2, y2, size?) → Two.Path
创建带箭头的路径并加入场景。源码实现(src/two.js#L680-L742)很直观:先以 Math.atan2 计算连线角度,构造主线段顶点(Commands.move、Commands.line)与两条呈 ±45° 的箭头线顶点(Commands.line),默认箭头长度 headlen = 10(传入 size 可自定义),最后 path.noFill() 并设置圆角 cap/join。
矩形与圆角矩形
makeRectangle(x, y, width, height) → Two.Rectangle
const rect = two.makeRectangle(100, 100, 50, 50);
rect.fill = 'rgb(255, 100, 100)';
rect.noStroke();
makeRoundedRectangle(x, y, width, height, radius) → Two.RoundedRectangle
radius 接受 Number 或 Two.Vector(可分别控制四个角的圆角半径)。
圆与椭圆
makeCircle(x, y, radius, resolution?) → Two.Circle
const circle = two.makeCircle(100, 100, 50);
makeEllipse(x, y, rx, ry, resolution?) → Two.Ellipse
resolution 默认为 4(源码 src/two.js#L789-L794 注释标明 [resolution=4]),控制圆弧细分程度。
星形与多边形
makeStar(x, y, innerRadius, outerRadius, sides) → Two.Star
const star = two.makeStar(100, 100, 30, 60, 5); // 五角星
makePolygon(x, y, radius, sides) → Two.Polygon
const hex = two.makePolygon(100, 100, 50, 6); // 正六边形
曲线、路径与点集
makeCurve(points) → Two.Path(path.curved === true)
两点用法:传入 Two.Anchor 数组,或直接传交替的 x/y 坐标值;两种形式下最后一个参数都可以是可选 Boolean,用于指定路径开/闭。创建后会自动居中并平移回包围盒中心(源码 src/two.js#L841-L870):
const curve = two.makeCurve(0, 0, 50, 80, 100, 40, true); // true 表示闭合
makePath(points) → Two.Path
同样支持 Two.Anchor 数组或交替 x/y 坐标值,最后一个参数同样可选开/闭 Boolean,同样自动居中:
const path = two.makePath(
new Two.Anchor(0, 0), new Two.Anchor(50, 80), new Two.Anchor(100, 40)
);
// 或
const path = two.makePath(0, 0, 50, 80, 100, 40, true);
makePoints(points) → Two.Points
支持 Two.Vector 数组或交替 x/y 坐标值(源码会将数值参数组合成 Two.Vector,见 src/two.js#L931-L952):
const pts = two.makePoints(0, 0, 20, 30, 40, 15, 60, 45);
弧段
makeArcSegment(x, y, innerRadius, outerRadius, startAngle, endAngle, resolution?) → Two.ArcSegment
resolution 为构成弧段的顶点数量,默认取 Two.Resolution(即 12)。
const arc = two.makeArcSegment(100, 100, 30, 60, 0, Math.PI * 1.5);
文本
makeText(message, x, y, styles?) → Two.Text
styles 可描述 Two.Text.Properties 中的任意属性,包括 fill、stroke、linewidth、family、alignment、leading、opacity 等:
const text = two.makeText('Hello Two.js', 200, 100, {
fill: '#333',
family: 'monospace',
size: 24,
alignment: 'center',
});
渐变
makeLinearGradient(x1, y1, x2, y2, ...args) → Two.LinearGradient
args 为任意数量的色标(ramp stops,即 Two.Stop);不提供时应用默认的黑→白两色渐变。效果类对象会被加入一个不可见的「definitions」组(对应 SVG 的 <defs> 概念):
const lg = two.makeLinearGradient(0, 0, 100, 100,
new Two.Stop(0, '#ff0000'),
new Two.Stop(1, '#0000ff')
);
rect.fill = lg;
makeRadialGradient(x1, y1, radius, ...args) → Two.RadialGradient
用法与线性渐变一致,只是以圆心 + 半径定义渐变区域:
const rg = two.makeRadialGradient(100, 100, 80,
new Two.Stop(0, '#ff0000'),
new Two.Stop(1, '#0000ff')
);
源码中两者均通过 Array.prototype.slice.call(arguments, 4 / 3) 收集剩余色标参数(src/two.js#L1031-L1038、src/two.js#L1050-L1057),不传色标时由渐变类内部补默认黑白色标。
精灵、图片与图片序列
makeSprite(src, x, y, columns?, rows?, frameRate?, autostart?) → Two.Sprite
src 为图片 URL 或已创建的 Two.Texture;columns/rows 用于把一张雪碧图切分为动画帧,frameRate 为播放帧率,autostart 为真则立即 play()。Sprite 既可当静态图片也可当动画使用:
const sprite = two.makeSprite('spritesheet.jpg', 0, 0, 8, 8, 30, true);
仓库测试资源 tests/images/spritesheet.jpg 即为这种整图切帧的典型素材。
makeImage(src, x, y, width, height, mode?) → Two.Image
图片会缩放以适配给定的宽高。mode 控制适配方式(如 'fill' 填充):
const img = two.makeImage('logo.png', 0, 0, 200, 100);
makeImageSequence(src, x, y, frameRate?, autostart?) → Two.ImageSequence
src 为图片路径数组或 Two.Texture 数组,按帧率顺序播放形成动画。仓库测试资源 tests/images/sequence/ 中 00000.png ~ 00029.png 即是供 ImageSequence 使用的序列帧素材:
const seq = two.makeImageSequence(
Array.from({ length: 30 }, (_, i) => `sequence/${String(i).padStart(5, '0')}.png`),
0, 0, 24, true
);
纹理与组
makeTexture(src, callback?) → Two.Texture
src 为图片 URL 或 DOM 图像类元素(HTMLImageElement/HTMLCanvasElement/HTMLVideoElement),callback 在图片加载完成后调用。注意:Texture 不会自动加入场景,它是可复用的图像资源对象。
makeGroup(objects) → Two.Group
支持传入 Two.js 对象数组或逐个参数,创建 Group 加入场景,并把对象归入组内。返回该组,可用于统一变换与组织层级(参见 Two.Group 文档):
const group = two.makeGroup(rect, circle, star);
group.rotation += 0.01; // 组内所有对象一起旋转
七、SVG 导入:interpret 与 load
interpret(svg, shallow?, add?)
Interpret an SVG Node and add it to this instance's scene. The distinction should be made that this doesn't
importsvg's, it solely interprets them into something compatible for Two.js - this is slightly different than a direct transcription.
svg:要解析的 SVG 节点;shallow:不创建最顶层的组,而是把所有内容直接追加;add:是否自动把重建后的 SVG 节点加入场景,默认true;- 返回
Two.Group。
实现要点(src/two.js#L1163-L1183):根据 svg.tagName 从 Two.Utils.read 中查找对应解析器(如 path、circle、rect 等),调用后获得 Two.js 对象;shallow 时若返回的是 Group 则直接取其 children 加入场景;add 为假时会把重建过程中临时加入场景的 g 标签移除,以兼容 getById 类方法。
const node = document.querySelector('svg');
const group = two.interpret(node); // 自动加入场景
load(pathOrSVGContent, callback?)
pathOrSVGContent:SVG 文件的 URL 路径,或作为文本的 SVG 文档字符串;callback:加载完成后调用的函数;- 返回
Two.Group。
实现(src/two.js#L1193-L1226):若传入以 .svg 结尾的路径,走 xhr(pathOrSVGContent, attach) 异步加载;否则直接把文本交给 attach。attach 内部把 SVG 文本放入临时 DOM 容器,逐个 interpret 子元素并加入返回的 Group,最后回调 callback(group, svg)。这是将外部 SVG 资产转成 Two.js 可绘制对象的推荐入口:
const group = two.load('/assets/scene.svg', (group, svg) => {
two.update(); // 加载完成后渲染一帧
});
SVG 导入相关测试可参考 tests/suite/svg-interpreter.js 与 tests/suite/svg.js,测试素材位于 tests/images/interpretation/(含 circle.svg、polygon.svg、compound-path.svg、linear-gradient.svg 等典型元素)。同时不要忘记上文提到的 Two.AutoCalculateImportedMatrices 开关:true 时 Two.js 会推断并覆盖参考 SVG 的精确变换矩阵,false 时原样拷贝矩阵但置 matrix.manual = true。
八、动画循环与事件驱动的完整示例
综合以上所有知识,一个完整的「场景搭建 → 绘制 → 动画 → 命中检测」示例:
const two = new Two({
width: 600,
height: 400,
type: Two.Types.canvas,
}).appendTo(document.body);
// 绘制对象
const rect = two.makeRectangle(150, 150, 60, 60);
rect.fill = '#2c6fbb';
const circle = two.makeCircle(300, 150, 40);
circle.fill = two.makeRadialGradient(300, 150, 60,
new Two.Stop(0, '#fff'),
new Two.Stop(1, '#2c6fbb')
);
const text = two.makeText('Two.js', 450, 160, { size: 28, alignment: 'center' });
// 监听 update 事件驱动动画(autostart: true 时自动触发)
two.bind('update', (frameCount, timeDelta) => {
rect.rotation += 0.01;
circle.scale = 1 + 0.1 * Math.sin(frameCount * 0.05);
});
// 命中检测:点击坐标对应的图形
two.bind('click', (e) => {
const hits = two.getShapesAtPoint(e.clientX, e.clientY, {
mode: 'deepest', // 只取最顶层
tolerance: 4, // 允许 4px 容差
});
hits.forEach((shape) => shape.opacity = 0.5);
});
two.play();
核心事件驱动链总结:play() → 全局 raf 循环遍历 Two.Instances 中 playing === true 的实例 → 调用 update()(触发 event:update)→ 内部 render()(触发 event:render,frameCount 递增)→ 渲染器绘制。仓库测试 tests/suite/core.js 中即包含 new Two().appendTo(elem) 后调用 two.play() 并 makeRectangle 绘制旋转矩形的完整验证流程。
九、进阶指引
- 想深入场景树与变换,阅读 Two.Group 与 Two.Matrix;
- 想定制路径与锚点,阅读 Two.Path 与 Two.Anchor;
- 想理解三种渲染后端差异,对比 renderers/svg、renderers/canvas、renderers/webgl 三份文档;
- 想查阅效果与图像能力,参见 effects 系列文档;
- 核心实现与类型声明始终以 src/two.js 与 src/two.d.ts 为准,测试验证见 tests/suite/。
总而言之,Two 是理解整个 Two.js 架构的钥匙:一个构造函数打通「渲染器选择、舞台尺寸、动画循环、场景根 Group」四大基础设施,一套 make* 工厂方法覆盖全部基础图形、文本、渐变与图像能力,再加上 interpret/load/getShapesAtPoint/release 等高层 API,让开发者可以用几乎相同的心智模型同时驾驭 SVG、Canvas 与 WebGL 三种渲染环境。