Skip to content

Commit 692b3d7

Browse files
AniBulletAniBullet
committed
暂时用ai生成说明，后面完善
1 parent 8fd414c commit 692b3d7

12 files changed

Lines changed: 2308 additions & 80 deletions

File tree

‎src/tools/bskeytools/ChainsTools.md‎

Lines changed: 85 additions & 75 deletions
Original file line numberDiff line numberDiff line change
@@ -1,125 +1,135 @@
11
---
2-
title: ChainsTools
3-
index: false
4-
icon: edit
2+
title: 链条工具 Chain Tools
3+
icon: link
4+
order: 5
55
category:
66
- BsKeyTools
7-
- Tool Docs
87
tag:
98
- ChainsTools
10-
- Maxscript
9+
- 绑定
10+
- 样条线
1111
---
1212

13-
## Chain Tools
13+
# Chain Tools 链条工具
1414

15-
![](https://www.joleanes.com/uploads/3/0/6/8/30680865/3439183_orig.jpg)
15+
使用样条线创建骨骼链绑定，适用于制作尾巴、脊椎、触手、绳索等柔性结构。
1616

17-
使用此工具，您可以创建连接到样条线的骨骼链，这对于制作弯曲的四肢或用于尾巴或脊椎的 IK 链很有用。它使用位置和观察约束或从骨骼到具有路径约束的助手的脚本控制器，以样条线为目标，可以应用偏移值。它可以使用样条 ik 求解器创建一个额外的链来控制拉伸。也可以使用样条线 IK 控件或蒙皮修改器将样条线约束到辅助对象。
17+
![Chain Tools](https://www.joleanes.com/uploads/3/0/6/8/30680865/3439183_orig.jpg)
1818

19-
## 设置
20-
21-
22-
**骨骼设置**：可以在此处编辑一些骨骼属性。
23-
24-
**骨骼：**要在链中创建的骨骼数量。
25-
**宽度：**链骨的宽度。
26-
**锥度：**链骨的锥度。
27-
**挤压：**设置拉伸选项以挤压链骨。
28-
29-
30-
**LookAt：**这是定位骨骼以查看其目标（附加到样条线的辅助对象）的方式。
31-
32-
**LookAt Constraint：**如果设置了这个选项，骨骼将分配标准的lookat约束，并将控制点助手作为目标
33-
**Quaternion Aim：**如果设置了这个选项，骨骼将有旋转脚本而不是lookat约束，优点是脚本控制器有一种通过构建四元数来查找旋转值的查看算法，这可以防止不需要的翻转，除非骨骼与其父级重叠（x 轴正在寻找相反的方向）。
34-
35-
36-
**链点设置：**链点是将通过路径约束附加到样条线的助手，在这里您可以设置它们的行为
37-
38-
39-
**滚动平均值：**链点将具有相对于控制点或微调器的方向平均值（x 旋转），具体取决于所选选项。
40-
41-
42-
**平均到：**
43-
44-
**第一个和最后一个控件：** 与样条曲线的第一个和最后一个顶点等效的控制点助手将控制滚动平均值。（控制点是控制样条顶点位置的助手）。
45-
**所有控制：**将考虑所有控制点来计算滚动平均值。
46-
**微调器：**滚动平均值将由存储在控制点持有的属性修改器中的微调器控制。
47-
48-
49-
**平均类型：**
50-
51-
**Quat 约束：**滚动平均值将使用 quat 计算来计算。如果控制点将持有任何不同于欧拉角的约束或控制器，这将很有用。
52-
**欧拉角：**滚动平均值将使用控制点旋转的 x 轨迹计算。将链条扭转超过 180 度而不翻转很有用，缺点是滚动平均值取自控制点的本地欧拉控制器，这意味着您不能为它们分配任何约束，或者与欧拉不同的旋转控制器角度。
19+
---
5320

21+
## ✨ 功能概述
5422

55-
**操纵控制器：** 如果选中此选项，则会将具有活动可编辑控制器的列表控制器分配给链点，以便独立编辑它们的变换，链点将同时具有位置、路径约束和活动控制器。
23+
- 🔗 创建连接到样条线的骨骼链
24+
- 🎯 支持 IK 拉伸控制
25+
- 🔄 多种朝向约束方式
26+
- ⚙️ 灵活的样条线控制选项
5627

28+
---
5729

58-
**Extra IK Solver Constraint：** 如果此选项处于活动状态，则可以控制链的拉伸，将创建一个微调器并将其分配给控制点。
30+
## 🦴 骨骼设置
5931

32+
| 参数 | 说明 |
33+
|:-----|:-----|
34+
| **Bones** | 链中创建的骨骼数量 |
35+
| **Width** | 链骨的宽度 |
36+
| **Taper** | 链骨的锥度 |
37+
| **Squash** | 启用拉伸时的挤压效果 |
6038

61-
**样条控制设置：**样条顶点的控制方式由这些属性定义
39+
---
6240

41+
## 🎯 朝向方式 (LookAt)
6342

64-
**样条线 IK 控制：**样条线顶点位置由使用样条线 IK 控制修改器的控制点控制。这种方法的缺点是您无法控制切线手柄的位置。唯一的方法是使用控制点旋转。
65-
**蒙皮：**样条线顶点位置由使用蒙皮修改器的控制点控制。这种方法的优点是您可以使用助手控制切线手柄的位置。
66-
**切线：**如果此选项处于活动状态，将创建助手来控制样条线顶点的切线手柄。
43+
骨骼朝向其目标（样条线上的辅助对象）的方式：
6744

45+
### LookAt Constraint
6846

47+
- 使用标准的 LookAt 约束
48+
- 以控制点助手作为目标
49+
- 设置简单直观
6950

70-
## 原文
51+
### Quaternion Aim
7152

72-
Description:With this tool you can create a chain of bones attached to a spline, useful to make bendy limbs or IK chains for tails or spines. It uses position and lookat constraints or scripted controllers from the bones to helpers which have path constraints with the spline as target, offset values can be aplied. It can create an extra chain with a spline ik solver to control stretching. The spline can also be constrained to helper objects using the Spline IK Control or the skin Modifier.
53+
- 使用旋转脚本代替 LookAt 约束
54+
- 通过四元数计算旋转值
55+
- **优点**：防止不必要的翻转
56+
- **注意**：骨骼与父级重叠时可能出现问题（X 轴方向相反）
7357

74-
## Settings
58+
---
7559

60+
## 📍 链点设置
7661

77-
**Bones Settings**: Some of the bones properties can be edited here.
62+
链点是通过路径约束附加到样条线的辅助对象。
7863

79-
**Bones:** The number of bones to create in the chain.
80-
**Width:** The width of the chain bones.
81-
**Taper:** The Taper of the chain bones.
82-
**Squash:** Set the stretch option to squash in the the chain bones.
64+
### 滚动平均值 (Roll Average)
8365

66+
链点的 X 旋转方向平均值设置：
8467

85-
**LookAt:** This is the way that the bones will be orientated to look their targets (the helpers attached to the spline).
68+
| 选项 | 说明 |
69+
|:-----|:-----|
70+
| **First and Last Controls** | 仅首尾控制点影响滚动 |
71+
| **All Controls** | 所有控制点参与计算 |
72+
| **Spinner** | 使用属性修改器中的滑块控制 |
8673

87-
**LookAt Constraint:** If this option is set the bones will have standard lookat constraints assigned having the control point helpers as targets
88-
**Quaternion Aim:** Is this option is set the bones will have rotation script instead of lookat constraint, the advantage is that the script controllers have a lookat algorithm that finds the rotation value by building a quaternion, this prevent undesirable flips, unless the bone overlaps its parent (the x axis are looking to opposite directions).
74+
### 平均类型 (Average Type)
8975

76+
| 类型 | 说明 | 适用场景 |
77+
|:-----|:-----|:---------|
78+
| **Quat Constraint** | 使用四元数计算 | 控制点有约束或非欧拉控制器 |
79+
| **Euler Angles** | 使用欧拉角 X 轨迹计算 | 需要超过 180° 扭转且不翻转 |
9080

91-
**Chain Points Settings:** The chain points are the helpers that are going to be attached to the spline via path constraint, here you can setup their behavior
81+
::: warning 欧拉角模式限制
82+
使用欧拉角时，控制点不能分配除欧拉角以外的约束或旋转控制器
83+
:::
9284

85+
### 操纵控制器
9386

94-
**Roll Average:** The chain points will have an orientation average (x-rotation) regards to control points or a spinner depending on the chosen option.
87+
勾选后为链点分配列表控制器，可独立编辑变换：
88+
- 同时拥有位置约束和可编辑控制器
89+
- 支持路径约束的同时进行手动调整
9590

91+
---
9692

97-
**Average To:**
93+
## 📏 IK 拉伸控制
9894

99-
**First and Last Controls:** The Control Point helpers equivalent to the first and last vertex of the spline will control the Roll average.(the Control points are helpers that control the spline vertices position).
100-
**All Controls:** All the Control Points will be considered to calculate the roll average.
101-
**Spinner:** The Roll average will be controlled by a spinner stored in an attribute modifier held by the control points.
95+
**Extra IK Solver Constraint**
10296

97+
启用此选项可控制链的拉伸：
98+
- 创建额外的样条线 IK 求解器
99+
- 生成拉伸控制滑块
100+
- 分配给控制点使用
103101

104-
**Average Type:**
102+
---
105103

106-
**Quat Constraint:** The roll average will be calculated using quat calculation. it useful if the control points will held any constraint or controller different than an Euler Angles.
107-
**Euler Angles:** The roll average will be calculated using the x track of the Control Points rotation. It is useful to twist the chain beyond 180 degrees without flipping, the disadvantage is that the roll average are taken from the local euler controller of the control points, that means that you can't assign them any constrain, or rotation controller different than euler angles.
104+
## 🎛️ 样条线控制
108105

106+
定义样条线顶点的控制方式：
109107

110-
**Manipulation Controllers:** If this option is checked a list controller with active editable controllers will be assigned to the chain points in order to edit their transform independently, the chain points will have both position, the path constraint and the active controller.
108+
| 方式 | 说明 | 特点 |
109+
|:-----|:-----|:-----|
110+
| **Spline IK Control** | 使用样条线 IK 控制修改器 | 无法直接控制切线手柄，需通过控制点旋转 |
111+
| **Skin** | 使用蒙皮修改器 | 可用助手控制切线手柄位置 |
112+
| **Tangents** | 创建切线控制助手 | 需配合 Skin 方式使用 |
111113

114+
---
112115

113-
**Extra IK Solver Constraint:** The stretch of the chain can be controlled if this option is active, a spinner will be created and assigned to the control points.
116+
## 💡 使用建议
114117

118+
### 适用场景
115119

116-
**Spline Control Settings:** The way that the spline vertices are controlled is defined by these properties
120+
- 🐍 尾巴、触手、蛇形生物
121+
- 🦴 柔性脊椎
122+
- 🔗 锁链、绳索
123+
- 🌿 藤蔓、植物茎干
117124

125+
### 最佳实践
118126

119-
**Spline IK Control:** The spline vertices position are controlled by the Control Points using a Spline IK control modifier. the disadvantage of this method is that you cannot control the tangents handles position. The only way is using the control Points rotation.
120-
**Skin:** The spline vertices position are controlled by the Control Points using a Skin modifier. the advantage of this method is that you can control the tangents handles position using helpers.
121-
**Tangents:** If this option is active Helpers will be created to control the tangent handles of the spline vertices.
127+
1. **骨骼数量**：根据需要的弯曲细节选择，一般 8-16 个
128+
2. **朝向方式**：优先使用 Quaternion Aim 避免翻转
129+
3. **样条控制**：需要控制切线时选择 Skin + Tangents
122130

131+
---
123132

133+
## 🔗 参考资料
124134

125-
> https://www.joleanes.com/chain-tools.html
135+
> 原作者：[Joleanes - Chain Tools](https://www.joleanes.com/chain-tools.html)

‎src/tools/bskeytools/README.md‎

Lines changed: 147 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,155 @@
11
---
2-
title: K帧工具_BsKeyTools
2+
title: BsKeyTools
33
index: false
4-
icon: edit
4+
icon: wand-magic-sparkles
55
category:
66
- BsKeyTools
77
---
88

9-
## 目录
9+
<div align="center">
1010

11-
B 站视频教程：[点击跳转](https://space.bilibili.com/2031113/lists/560782)
11+
# BsKeyTools
1212

13-
- [ChainsTools](chainstools.md)
13+
**Bullet.S KeyTools - All for Animator**
14+
15+
*专为 3ds Max 动画师打造的综合工具集*
16+
17+
![Demo](https://raw.githubusercontent.com/AniBullet/BsKeyTools/main/BsKeyToolsPrev.gif)
18+
19+
[![GitHub](https://img.shields.io/badge/GitHub-BsKeyTools-blue?style=flat-square&logo=github)](https://github.com/AniBullet/BsKeyTools)
20+
[![Latest Release](https://img.shields.io/badge/下载-最新版本-success?style=flat-square&logo=github)](https://github.com/AniBullet/BsKeyTools/releases/latest)
21+
[![Bilibili](https://img.shields.io/badge/B站-视频教程-ff69b4?style=flat-square&logo=bilibili)](https://space.bilibili.com/2031113/lists/560782)
22+
23+
</div>
24+
25+
---
26+
27+
## 📖 文档导航
28+
29+
### 入门指南
30+
31+
| 文档 | 说明 |
32+
|:-----|:-----|
33+
| [🚀 快速入门](quickstart.md) | 5 分钟上手 BsKeyTools |
34+
| [📥 安装指南](install.md) | 自动安装与手动安装详解 |
35+
| [📋 功能总览](features.md) | 100+ 工具功能一览表 |
36+
37+
### 工具详解
38+
39+
| 文档 | 说明 |
40+
|:-----|:-----|
41+
| [🎬 动画工具](animation.md) | 关键帧、补间、镜像、烘焙等 |
42+
| [🦴 骨骼绑定](rigging.md) | Biped、链条、扭曲骨骼、飘带等 |
43+
| [🎨 蒙皮权重](skinning.md) | 权重编辑、替换骨骼、平滑等 |
44+
| [📁 场景管理](scene.md) | 备份、图层、选择集、病毒防护等 |
45+
| [👁️ 视口显示](viewport.md) | 洋葱皮、构图框、参考播放等 |
46+
| [🔄 动画重定向](retarget.md) | FBX↔Biped、Root Motion 等 |
47+
48+
### 插件与扩展
49+
50+
| 文档 | 说明 |
51+
|:-----|:-----|
52+
| [🧩 独立插件](plugins.md) | GhostTrails / AnimLibrary / AnimRef |
53+
| [🔗 链条工具](ChainsTools.md) | 样条线骨骼链创建工具详解 |
54+
55+
---
56+
57+
## ✨ 核心功能
58+
59+
### 🎬 动画制作
60+
61+
- **关键帧操作**：选择、移动、复制、粘贴关键帧
62+
- **补间动画**：TweenMachine 快速创建补间
63+
- **动画镜像**：左右对称动画复制
64+
- **轨迹编辑**：可视化调整运动路径
65+
- **动画烘焙**：约束转关键帧
66+
67+
### 🦴 骨骼绑定
68+
69+
- **Biped 工具**：专业 Biped 工具集
70+
- **链条绑定**：样条线骨骼链系统
71+
- **飘带解算**：简易动力学模拟
72+
- **扭曲骨骼**：改善关节变形
73+
74+
### 🎨 蒙皮权重
75+
76+
- **权重编辑**：专业权重绘制工具
77+
- **权重平滑**：分区平滑权重
78+
- **蒙皮换骨**：替换骨骼引用
79+
- **蒙皮拆合**：保留权重的拆分合并
80+
81+
### 📁 场景管理
82+
83+
- **自动备份**：保护工作成果
84+
- **图层管理**：增强图层操作
85+
- **病毒防护**：内置病毒扫描清理
86+
- **批量处理**：批量导入导出
87+
88+
### 👁️ 视口工具
89+
90+
- **洋葱皮**：运动重影显示
91+
- **构图框**：经典构图辅助
92+
- **参考播放**：视口内播放参考视频
93+
- **残影效果**：GhostTrails 插件
94+
95+
---
96+
97+
## 🔢 工具统计
98+
99+
| 统计项 | 数量 |
100+
|:------|-----:|
101+
| 主面板功能 | 27 个 |
102+
| 扩展工具按钮 | 48 个 |
103+
| 独立工具模块 | 21 个 |
104+
| 引用/集成工具 | 34 个 |
105+
| 独立插件 | 3 个 |
106+
| **合计** | **100+** |
107+
108+
---
109+
110+
## 🎯 版本兼容
111+
112+
| 项目 | 支持 |
113+
|:-----|:-----|
114+
| 3ds Max | 2014 - 2026 全版本 |
115+
| 语言 | 中文 / English |
116+
| 系统 | Windows 64-bit |
117+
118+
---
119+
120+
## 🏆 特色亮点
121+
122+
| 特性 | 说明 |
123+
|:-----|:-----|
124+
| 🌐 **双语支持** | 中/英界面切换 |
125+
| 🎨 **主题系统** | 图标/文字模式切换 |
126+
| ⚡ **可定制** | 按钮布局自由排序 |
127+
| 📦 **模块化** | 独立插件可单独使用 |
128+
| 🛡️ **安全防护** | 内置病毒扫描 |
129+
| 🔄 **自动更新** | 在线检查更新 |
130+
131+
---
132+
133+
## 🔗 相关链接
134+
135+
| 资源 | 链接 |
136+
|:-----|:-----|
137+
| 📺 **视频教程** | [Bilibili 教程合集](https://space.bilibili.com/2031113/lists/560782) |
138+
| 📚 **英文文档** | [DeepWiki](https://deepwiki.com/AniBullet/BsKeyTools) |
139+
| 💬 **交流群1** | [QQ群 993590655](https://jq.qq.com/?_wv=1027&k=hmeHhTwu) |
140+
| 💬 **交流群2** | [QQ群 907481113](https://qm.qq.com/q/FZ2gBKJeYE) |
141+
| 🌐 **个人主页** | [AniBullet.com](https://www.anibullet.com/) |
142+
| 🔗 **社交链接** | [bio.site/aniBullet](https://bio.site/aniBullet) |
143+
144+
---
145+
146+
::: tip 💡 提示
147+
main 分支更新较慢，可前往 [dev 分支](https://github.com/AniBullet/BsKeyTools/tree/dev) 查看最新进度！
148+
:::
149+
150+
::: warning ⚠️ 声明
151+
- 个人业余学习作品，无任何商业用途
152+
- 部分工具引用和参考其他脚本，均有注明
153+
- 工具基本开源无任何收费，请勿商用
154+
- 转载或修改工具请注明作者和来源
155+
:::

0 commit comments

Comments
 (0)