NormalCrafter 使用教程

1. 项目介绍

NormalCrafter 是一个开源项目，旨在生成具有细粒度细节的时序一致法线序列，适用于任意长度的开放世界视频。该项目由香港理工大学空间智能组、腾讯PCG ARC实验室、香港城市大学以及华中科技大学的研究人员共同开发。

2. 项目快速启动

环境准备

首先，需要克隆该仓库到本地：

git clone [e-mail]:Binyr/NormalCrafter.git

接着，安装项目所需的依赖：

pip install -r requirements.txt

启动示例

对于大约20GB显存的高分辨率推理（1024x576分辨率），可以使用以下命令：

python run.py --video-path examples/example_01.mp4

对于大约6GB显存的低分辨率推理（512x256分辨率），可以使用以下命令：

python run.py --video-path examples/example_01.mp4 --max-res 512

3. 应用案例和最佳实践

• 案例一：将NormalCrafter应用于游戏开发中，为游戏角色生成动态且细腻的法线映射，提升游戏画面的真实感。
• 案例二：在影视后期制作中，利用NormalCrafter为视频序列添加高质量的法线信息，增强视觉效果。

4. 典型生态项目

NormalCrafter 可以与以下开源项目或工具结合使用，以构建更加完善的技术生态：

• OpenCV：用于图像处理和视频分析。
• TensorFlow 或 PyTorch：用于深度学习和模型训练。
• Gradio：用于创建Web界面，方便展示NormalCrafter的效果。

通过上述的介绍和指导，用户可以快速上手NormalCrafter，并在实际项目中加以应用。