vislite 1.12.0 → 2.0.0-next.0

package/skills/vislite-lib/Interpolation.md

@@ -1,130 +1,130 @@
-# 插值函数 API
-
-VISLite 提供 Cardinal 和 Hermite 两种三次插值函数，用于平滑曲线绘制。
-
-## Hermite 插值
-
-Hermite 插值需要指定两个端点和两个端点处的斜率。
-
-### 引入
-
-```js
-import { Hermite } from 'vislite';
-```
-
-### 初始化
-
-```js
-var hermite = new Hermite(u);
-```
-
-- **u**: 张弛系数，控制曲线在端点处的弯曲程度，默认 0.5
-
-### 设置点位置
-
-```js
-hermite.setP(x1, y1, x2, y2, s1, s2);
-```
-
-参数说明：
-- **x1, y1**: 左边点位置
-- **x2, y2**: 右边点位置
-- **s1**: 左边点的切线斜率
-- **s2**: 右边点的切线斜率
-
-### 计算插值
-
-```js
-var y = hermite.use(x);
-```
-
-根据 x 值返回对应的 y 值。
-
-### 示例
-
-```js
-var hermite = new Hermite(0.5);
-
-hermite.setP(0, 0, 100, 100, 0, 1);
-
-// 计算x=50时的y值
-var y = hermite.use(50);
-```
-
----
-
-## Cardinal 插值
-
-Cardinal 插值是 Hermite 的扩展，只需提供点序列，系统自动计算斜率。
-
-### 引入
-
-```js
-import { Cardinal } from 'vislite';
-```
-
-### 初始化
-
-```js
-var cardinal = new Cardinal(t);
-```
-
-- **t**: 张弛系数，控制曲线走势，默认 0
-  - t = 0：默认曲线
-  - t = -1：分水岭效果
-  - |t| 越大，曲线调整越剧烈
-
-### 设置点序列
-
-```js
-cardinal.setP([[x1, y1], [x2, y2], [x3, y3], ...]);
-```
-
-至少需要两个点。
-
-### 计算插值
-
-```js
-var y = cardinal.use(x);
-```
-
-根据 x 值返回对应的 y 值。
-
-### 示例
-
-```js
-var cardinal = new Cardinal(0);
-
-cardinal.setP([
-    [0, 0],
-    [25, 25],
-    [50, 10],
-    [75, 50],
-    [100, 100]
-]);
-
-// 绘制平滑曲线
-for (var x = 0; x <= 100; x += 1) {
-    var y = cardinal.use(x);
-    painter.lineTo(x, y);
-}
-painter.stroke();
-```
-
----
-
-## 对比与选择
-
-| 特性 | Hermite | Cardinal |
-|------|---------|----------|
-| 端点斜率 | 手动指定 | 自动计算 |
-| 参数数量 | 6个 | 2个（点序列） |
-| 灵活性 | 高（可自定义斜率） | 中（受邻近点影响） |
-| 适用场景 | 精确控制曲线形状 | 自然平滑的曲线 |
-
-## 应用场景
-
-- **折线图平滑**: 使用 Cardinal
-- **动画路径**: 使用 Hermite 自定义缓动
-- **字体渲染**: 使用 Cardinal 平滑字形边缘
+# 插值函数 API
+
+VISLite 提供 Cardinal 和 Hermite 两种三次插值函数，用于平滑曲线绘制。
+
+## Hermite 插值
+
+Hermite 插值需要指定两个端点和两个端点处的斜率。
+
+### 引入
+
+```js
+import { Hermite } from 'vislite';
+```
+
+### 初始化
+
+```js
+var hermite = new Hermite(u);
+```
+
+- **u**: 张弛系数，控制曲线在端点处的弯曲程度，默认 0.5
+
+### 设置点位置
+
+```js
+hermite.setP(x1, y1, x2, y2, s1, s2);
+```
+
+参数说明：
+- **x1, y1**: 左边点位置
+- **x2, y2**: 右边点位置
+- **s1**: 左边点的切线斜率
+- **s2**: 右边点的切线斜率
+
+### 计算插值
+
+```js
+var y = hermite.use(x);
+```
+
+根据 x 值返回对应的 y 值。
+
+### 示例
+
+```js
+var hermite = new Hermite(0.5);
+
+hermite.setP(0, 0, 100, 100, 0, 1);
+
+// 计算x=50时的y值
+var y = hermite.use(50);
+```
+
+---
+
+## Cardinal 插值
+
+Cardinal 插值是 Hermite 的扩展，只需提供点序列，系统自动计算斜率。
+
+### 引入
+
+```js
+import { Cardinal } from 'vislite';
+```
+
+### 初始化
+
+```js
+var cardinal = new Cardinal(t);
+```
+
+- **t**: 张弛系数，控制曲线走势，默认 0
+  - t = 0：默认曲线
+  - t = -1：分水岭效果
+  - |t| 越大，曲线调整越剧烈
+
+### 设置点序列
+
+```js
+cardinal.setP([[x1, y1], [x2, y2], [x3, y3], ...]);
+```
+
+至少需要两个点。
+
+### 计算插值
+
+```js
+var y = cardinal.use(x);
+```
+
+根据 x 值返回对应的 y 值。
+
+### 示例
+
+```js
+var cardinal = new Cardinal(0);
+
+cardinal.setP([
+    [0, 0],
+    [25, 25],
+    [50, 10],
+    [75, 50],
+    [100, 100]
+]);
+
+// 绘制平滑曲线
+for (var x = 0; x <= 100; x += 1) {
+    var y = cardinal.use(x);
+    painter.lineTo(x, y);
+}
+painter.stroke();
+```
+
+---
+
+## 对比与选择
+
+| 特性 | Hermite | Cardinal |
+|------|---------|----------|
+| 端点斜率 | 手动指定 | 自动计算 |
+| 参数数量 | 6个 | 2个（点序列） |
+| 灵活性 | 高（可自定义斜率） | 中（受邻近点影响） |
+| 适用场景 | 精确控制曲线形状 | 自然平滑的曲线 |
+
+## 应用场景
+
+- **折线图平滑**: 使用 Cardinal
+- **动画路径**: 使用 Hermite 自定义缓动
+- **字体渲染**: 使用 Cardinal 平滑字形边缘
 - **地图等高线**: 使用 Hermite 精确控制地形变化

package/skills/vislite-lib/Matrix.md

@@ -1,175 +1,175 @@
-# Matrix4 矩阵变换
-
-Matrix4 提供 4x4 矩阵变换能力，用于复杂的图形变换。
-
-## 引入
-
-```js
-import { Matrix4 } from 'vislite';
-```
-
-## 初始化
-
-```js
-var matrix = new Matrix4();
-// 或指定初始矩阵
-var matrix = new Matrix4([1,0,0,0, 0,1,0,0, 0,0,1,0, 0,0,0,1]);
-```
-
-## 基本变换
-
-### 平移
-
-```js
-matrix.move(dis, a, b, c);
-```
-
-参数说明：
-- **dis**: 移动距离
-- **a, b, c**: 移动方向向量的 x, y, z 分量
-
-```js
-// 向x轴正方向移动10
-matrix.move(10, 1, 0, 0);
-
-// 向y轴负方向移动5
-matrix.move(-5, 0, 1, 0);
-```
-
-### 旋转
-
-```js
-matrix.rotate(deg, a1, b1, c1, a2, b2, c2);
-```
-
-参数说明：
-- **deg**: 旋转角度（弧度制）
-- **a1, b1, c1**: 旋转轴向量（确定旋转平面）
-- **a2, b2, c2**: 旋转正方向向量
-
-```js
-// 绕x轴旋转
-matrix.rotate(Math.PI, 1, 0, 0);
-
-// 绕y轴旋转
-matrix.rotate(Math.PI, 0, 1, 0);
-
-// 绕z轴旋转
-matrix.rotate(Math.PI, 0, 0, 1);
-```
-
-### 缩放
-
-```js
-matrix.scale(xTimes, yTimes, zTimes, cx, cy, cz);
-```
-
-参数说明：
-- **xTimes, yTimes, zTimes**: 各轴缩放比例
-- **cx, cy, cz**: 缩放中心点坐标
-
-```js
-// 以原点为中心放大2倍
-matrix.scale(2, 2, 2);
-
-// 以(10, 10, 0)为中心放大
-matrix.scale(2, 2, 1, 10, 10, 0);
-```
-
-## 矩阵运算
-
-### 矩阵乘法
-
-```js
-matrix.multiply(newMatrix4, flag);
-```
-
-- **flag**: false（默认）新矩阵左乘当前矩阵；true 则右乘
-
-### 应用变换
-
-```js
-var [x, y, z, w] = matrix.use(px, py, pz, pw);
-```
-
-将变换应用到坐标点，返回变换后的齐次坐标。
-
-### 获取矩阵值
-
-```js
-var values = matrix.value();
-```
-
-返回 4x4 矩阵的 16 个元素数组（列主序存储）。
-
-### 重置矩阵
-
-```js
-matrix.setValue([1,0,0,0, 0,1,0,0, 0,0,1,0, 0,0,0,1]);
-```
-
-## 使用示例
-
-### 组合变换
-
-```js
-var matrix = new Matrix4();
-
-// 先平移再旋转
-matrix.move(100, 1, 0, 0);
-matrix.rotate(Math.PI / 4, 0, 0, 1);
-
-// 应用到点
-var [x, y] = matrix.use(10, 20, 0);
-```
-
-### 3D 变换
-
-```js
-var matrix = new Matrix4();
-
-// 绕x轴旋转45度
-matrix.rotate(Math.PI / 4, 1, 0, 0);
-
-// 绕y轴旋转30度
-matrix.rotate(Math.PI / 6, 0, 1, 0);
-
-// 应用到3D点
-var [x, y, z, w] = matrix.use(10, 20, 30);
-```
-
----
-
-## 基础变换函数
-
-除 Matrix4 类外，还提供独立的基础变换函数：
-
-### rotate 旋转
-
-```js
-import { rotate } from 'vislite';
-
-var [x, y] = rotate(cx, cy, deg, px, py);
-```
-
-绕点 (cx, cy) 旋转 deg 弧度后的 (px, py) 坐标。
-
-### move 平移
-
-```js
-import { move } from 'vislite';
-
-var [x, y, z] = move(dis, a, b, c, px, py, pz);
-```
-
-沿向量 (a, b, c) 方向移动 dis 距离后的坐标。
-
-### scale 缩放
-
-```js
-import { scale } from 'vislite';
-
-var [x, y, z] = scale(times, cx, cy, cz, px, py, pz);
-```
-
+# Matrix4 矩阵变换
+
+Matrix4 提供 4x4 矩阵变换能力，用于复杂的图形变换。
+
+## 引入
+
+```js
+import { Matrix4 } from 'vislite';
+```
+
+## 初始化
+
+```js
+var matrix = new Matrix4();
+// 或指定初始矩阵
+var matrix = new Matrix4([1,0,0,0, 0,1,0,0, 0,0,1,0, 0,0,0,1]);
+```
+
+## 基本变换
+
+### 平移
+
+```js
+matrix.move(dis, a, b, c);
+```
+
+参数说明：
+- **dis**: 移动距离
+- **a, b, c**: 移动方向向量的 x, y, z 分量
+
+```js
+// 向x轴正方向移动10
+matrix.move(10, 1, 0, 0);
+
+// 向y轴负方向移动5
+matrix.move(-5, 0, 1, 0);
+```
+
+### 旋转
+
+```js
+matrix.rotate(deg, a1, b1, c1, a2, b2, c2);
+```
+
+参数说明：
+- **deg**: 旋转角度（弧度制）
+- **a1, b1, c1**: 旋转轴向量（确定旋转平面）
+- **a2, b2, c2**: 旋转正方向向量
+
+```js
+// 绕x轴旋转
+matrix.rotate(Math.PI, 1, 0, 0);
+
+// 绕y轴旋转
+matrix.rotate(Math.PI, 0, 1, 0);
+
+// 绕z轴旋转
+matrix.rotate(Math.PI, 0, 0, 1);
+```
+
+### 缩放
+
+```js
+matrix.scale(xTimes, yTimes, zTimes, cx, cy, cz);
+```
+
+参数说明：
+- **xTimes, yTimes, zTimes**: 各轴缩放比例
+- **cx, cy, cz**: 缩放中心点坐标
+
+```js
+// 以原点为中心放大2倍
+matrix.scale(2, 2, 2);
+
+// 以(10, 10, 0)为中心放大
+matrix.scale(2, 2, 1, 10, 10, 0);
+```
+
+## 矩阵运算
+
+### 矩阵乘法
+
+```js
+matrix.multiply(newMatrix4, flag);
+```
+
+- **flag**: false（默认）新矩阵左乘当前矩阵；true 则右乘
+
+### 应用变换
+
+```js
+var [x, y, z, w] = matrix.use(px, py, pz, pw);
+```
+
+将变换应用到坐标点，返回变换后的齐次坐标。
+
+### 获取矩阵值
+
+```js
+var values = matrix.value();
+```
+
+返回 4x4 矩阵的 16 个元素数组（列主序存储）。
+
+### 重置矩阵
+
+```js
+matrix.setValue([1,0,0,0, 0,1,0,0, 0,0,1,0, 0,0,0,1]);
+```
+
+## 使用示例
+
+### 组合变换
+
+```js
+var matrix = new Matrix4();
+
+// 先平移再旋转
+matrix.move(100, 1, 0, 0);
+matrix.rotate(Math.PI / 4, 0, 0, 1);
+
+// 应用到点
+var [x, y] = matrix.use(10, 20, 0);
+```
+
+### 3D 变换
+
+```js
+var matrix = new Matrix4();
+
+// 绕x轴旋转45度
+matrix.rotate(Math.PI / 4, 1, 0, 0);
+
+// 绕y轴旋转30度
+matrix.rotate(Math.PI / 6, 0, 1, 0);
+
+// 应用到3D点
+var [x, y, z, w] = matrix.use(10, 20, 30);
+```
+
+---
+
+## 基础变换函数
+
+除 Matrix4 类外，还提供独立的基础变换函数：
+
+### rotate 旋转
+
+```js
+import { rotate } from 'vislite';
+
+var [x, y] = rotate(cx, cy, deg, px, py);
+```
+
+绕点 (cx, cy) 旋转 deg 弧度后的 (px, py) 坐标。
+
+### move 平移
+
+```js
+import { move } from 'vislite';
+
+var [x, y, z] = move(dis, a, b, c, px, py, pz);
+```
+
+沿向量 (a, b, c) 方向移动 dis 距离后的坐标。
+
+### scale 缩放
+
+```js
+import { scale } from 'vislite';
+
+var [x, y, z] = scale(times, cx, cy, cz, px, py, pz);
+```
+
 以 (cx, cy, cz) 为中心缩放 times 倍后的坐标。