HDRI转立方图指南

本项目HDRI-to-CubeMap致力于将球面贴图转换为立方体贴图，简化环境光照映射的处理流程。通过直观的界面，用户可以轻松地将HDR或普通图像格式（如.png, .jpg）转换成适用于实时渲染的立方体贴图。本文档旨在提供详尽的指导，帮助您从安装到高效使用该工具。

安装指南

要本地运行此项目以获得最佳体验，请遵循以下步骤：

1. 确保您的计算机已安装node.js。
2. 克隆项目到本地计算机：

   git clone https://github.com/matheowis/HDRI-to-CubeMap.git
   

3. 进入项目根目录：

   cd HDRI-to-CubeMap
   

4. 安装依赖项：

   npm install
   

5. 启动项目：

   npm start
   

完成上述步骤后，项目将在http://localhost:8080/上运行。

项目的使用说明

一旦项目在本地启动，您可以按照以下流程操作：

1. 上传图片: 选择一个球面地图文件（支持.hdr, .png, .jpg格式）进行上传。
2. 预览: 上传后，系统会显示预览图，允许您旋转查看效果。
3. 转换与保存: 满意后，点击保存按钮下载生成的立方体贴图。

提示: 使用高清但不过大的源图（建议不超过4096px），以避免内存耗尽导致的问题。

项目API使用文档

该项目主要是前端应用，并未明确提供外部API接口。对于开发者希望集成其转换逻辑至其他应用的情况，推荐深入研究项目源代码，了解核心转换函数实现细节。关键逻辑位于JavaScript文件中，特别是处理图像上传与转换的部分。

注意事项与已知问题

• RAM限制: 高分辨率源图可能消耗大量内存，导致WebGL上下文丢失，表现为黑屏。确保资源管理适当，以避免页面异常停止工作。
• 本地运行优势: 本地环境相较于在线版本表现更佳，便于调试与高负载处理。
• 资源获取: 用户可从类似hdrihaven.com的网站获取球面地图用于测试。

通过以上指引，相信您可以顺利地利用HDRI-to-CubeMap进行高效的图像格式转换，提升您的环境光照设计工作流程。