迁移指南
这一章汇总了各版本之间的升级说明。按版本跨度选择你需要的那一份：
| 你的起点 | 看这里 |
|---|---|
| 旧版 Cornerstone（cornerstone-core / cornerstone-tools） | 从旧版迁移到 3D |
| 1.x | 2.0 迁移指南 |
| 2.x | 3.0 迁移指南 |
| 3.x | 4.0 迁移指南 |
| 4.x | 5.0 迁移指南 |
如果要跨多个大版本升级（例如从 2.x 直接升到 5.x）， 请按顺序依次阅读中间各版本的指南——破坏性变更是累积的。
先读这一篇
2.x 是架构变动最大的一次（分割从「绑定工具组的工具」改为一等数据结构， 并引入了 VoxelManager）。如果你要从 1.x 升级， 建议先读前行之路了解这次架构调整的动机，再动手改代码。
2x
8 个项目
3x
5 个项目
4.0 迁移指南
6 个项目
5.0 迁移指南
2 个项目
前行之路
Cornerstone3D 2.x 架构调整的缘由。分割从「绑定工具组的工具」转变为一等数据结构，改为以视口为中心的架构；同时引入 VoxelManager 取代笨重的标量数据数组，以基于影像的方式管理体素数据。
从旧版迁移到 Cornerstone3D 1.0
从旧版 Cornerstone 迁移到 Cornerstone3D 1.0 的完整对照指南。逐项对比 init、enabledElement、loadAndCacheImage、displayImage、updateImage、disable、坐标换算与 getPixels 的新旧写法，并给出事件数据结构的变化及其缘由。