ComfyUI-Equirect is a set of nodes designed for transforming equirectangular panoramas into cubemap formats and vice versa within the ComfyUI framework. This tool streamlines the conversion process, allowing users to efficiently manipulate panoramic images for various applications.
- Provides two primary nodes: one for converting equirectangular images to cubemap faces and another for the reverse operation.
- Utilizes the
py360convertlibrary for high-quality image transformations, with a fallback to a custom implementation if necessary. - Supports batch processing, ensuring that multiple images can be processed while maintaining the correct format and quality.
Context
ComfyUI-Equirect serves as an extension within the ComfyUI ecosystem, specifically targeting the conversion between equirectangular panoramas and cubemaps. Its primary purpose is to facilitate seamless transformations that are essential for applications in 3D graphics, virtual reality, and panoramic image processing.
Key Features & Benefits
The tool includes two main nodes: the EquirectToCubemapNode and the CubemapToEquirectNode. The former allows users to convert a 2:1 aspect ratio equirectangular image into six distinct cubemap faces, which is crucial for rendering in 3D environments. Conversely, the latter node enables the conversion of cubemap faces back into a single equirectangular panorama, making it easier to work with different image formats in various workflows.
Advanced Functionalities
The nodes can accept parameters such as face size and field of view (FOV), allowing users to customize the output to meet specific requirements. The EquirectToCubemapNode can output cubemap faces in a user-defined size, while the CubemapToEquirectNode adjusts the output height based on user input, automatically calculating the width. This flexibility is particularly useful for users needing precise control over image dimensions.
Practical Benefits
By integrating ComfyUI-Equirect into their workflow, users can enhance their efficiency in handling panoramic images. The ability to batch process images not only saves time but also ensures consistency in output quality. This functionality is especially beneficial for projects that require frequent conversions between image formats, such as game development, virtual tours, or 3D modeling.
Credits/Acknowledgments
This project is developed under the MIT License, with contributions from the open-source community. The use of the py360convert library is acknowledged for its role in providing high-quality conversion capabilities.