Unity3DRuntimeTransformGizmo的撤销重做系统：完整实现与使用指南

【免费下载链接】Unity3DRuntimeTransformGizmoA runtime transform gizmo similar to unitys editor so you can translate (move, rotate, scale) objects at runtime.项目地址: https://gitcode.com/gh_mirrors/un/Unity3DRuntimeTransformGizmo

Unity3DRuntimeTransformGizmo是一款强大的运行时变换 gizmo 工具，类似于 Unity 编辑器中的变换工具，让你能够在运行时对物体进行平移、旋转和缩放操作。其中的撤销重做系统是提升用户体验的关键功能，本文将详细介绍其实现原理和使用方法。

撤销重做系统的核心组件

撤销重做系统主要由以下几个核心文件组成：

• ICommand.cs：定义了命令接口，所有可撤销操作都需要实现此接口
• UndoRedoManager.cs：提供静态方法管理撤销重做操作
• UndoRedo.cs：实现撤销重做的核心逻辑
• CommandGroup.cs：用于组合多个命令，实现批量撤销重做

ICommand 接口详解

ICommand 接口是整个撤销重做系统的基础，定义了两个关键方法：

public interface ICommand { void Execute(); // 执行命令 void UnExecute(); // 撤销命令 }

所有可撤销的操作（如移动、旋转、缩放物体）都需要实现这个接口，确保操作可以被记录和反向执行。

如何使用撤销重做功能

基本操作方法

UndoRedoManager 提供了简洁的 API 来管理撤销重做操作：

// 撤销上一步操作 UndoRedoManager.Undo(); // 重做上一步撤销的操作 UndoRedoManager.Redo(); // 清除所有撤销历史 UndoRedoManager.Clear(); // 设置最大撤销步数 UndoRedoManager.maxUndoStored = 20;

在项目中集成撤销重做

在 TransformGizmo 类中，已经集成了撤销重做功能。当你对物体进行变换操作时，相关命令会自动被记录：

// 插入新命令到撤销栈 UndoRedoManager.Insert(commandGroup);

常见的可撤销操作包括：

• 添加目标物体 (AddTargetCommand)
• 移除目标物体 (RemoveTargetCommand)
• 清除所有目标物体 (ClearTargetsCommand)
• 变换物体操作 (TransformCommand)

高级用法：自定义可撤销命令

要创建自定义的可撤销命令，只需实现 ICommand 接口：

public class CustomCommand : ICommand { private object _state; public CustomCommand(object initialState) { _state = initialState; } public void Execute() { // 执行操作并保存状态 } public void UnExecute() { // 恢复之前保存的状态 } }

然后使用 UndoRedoManager 插入命令：

var command = new CustomCommand(originalState); UndoRedoManager.Insert(command);

最佳实践与注意事项

1. 设置合理的最大撤销步数：根据项目需求设置合适的 maxUndoStored 值，默认可设置为 20-50 步

2. 复杂操作使用 CommandGroup：当需要同时撤销多个相关操作时，使用 CommandGroup 组合命令

3. 资源清理：在切换场景或进行重大操作前，调用 UndoRedoManager.Clear() 清理撤销历史

4. 性能考量：对于涉及大量数据的操作，确保 UnExecute 方法高效，避免卡顿

总结

Unity3DRuntimeTransformGizmo 的撤销重做系统通过命令模式实现，提供了灵活而强大的撤销重做功能。通过 UndoRedoManager 类，开发者可以轻松地在项目中集成撤销重做功能，提升用户体验。无论是使用内置的变换命令，还是创建自定义命令，都能享受到这套系统带来的便利。

要开始使用这个强大的工具，只需克隆仓库：

git clone https://gitcode.com/gh_mirrors/un/Unity3DRuntimeTransformGizmo

然后参考 ExampleScene.unity 中的示例，快速将撤销重做功能集成到你的项目中。

【免费下载链接】Unity3DRuntimeTransformGizmoA runtime transform gizmo similar to unitys editor so you can translate (move, rotate, scale) objects at runtime.项目地址: https://gitcode.com/gh_mirrors/un/Unity3DRuntimeTransformGizmo