ComfyUI Node: UltraShape Save GLB/OBJ

UltraShape Save GLB/OBJ:

The UltraShapeSaveGLB node is designed to facilitate the saving of refined 3D meshes into a GLB file format, which is a widely used format for 3D models due to its compactness and efficiency in storing complex 3D data. This node is particularly beneficial for AI artists and designers who work with 3D models and need a streamlined process to export their refined meshes into a format that is easily shareable and compatible with various 3D applications and platforms. By automating the export process, UltraShapeSaveGLB ensures that your refined meshes are saved with a unique filename, incorporating a timestamp and a unique identifier, which helps in organizing and managing multiple outputs efficiently. This node not only supports the GLB format but also offers flexibility by allowing the export of meshes in other formats such as OBJ, PLY, and STL, catering to different project requirements and preferences.

UltraShape Save GLB/OBJ Input Parameters:

refined_mesh

The refined_mesh parameter is a required input that represents the 3D mesh you wish to save. This mesh is typically the output of a refinement process and is expected to be in the ULTRASHAPE_OUTPUT format. The quality and detail of this mesh directly impact the final saved file, making it crucial to ensure that the mesh is fully refined and ready for export.

output_dir

The output_dir parameter is an optional string that specifies the directory where the exported file will be saved. By default, this is set to "ultrashape_output". This parameter allows you to organize your files by directing the output to a specific folder, which can be particularly useful for managing multiple projects or iterations.

filename_prefix

The filename_prefix parameter is an optional string that sets the prefix for the exported file's name. The default value is "refined". This prefix is combined with a timestamp and a unique identifier to create a unique filename, helping to prevent overwriting and ensuring that each file can be easily identified and traced back to its source or version.

file_format

The file_format parameter is an optional choice that determines the format in which the mesh will be saved. Available options include "glb", "obj", "ply", and "stl", with "glb" being the default. This flexibility allows you to choose the format that best suits your needs, whether you require a compact binary format like GLB or a more traditional format like OBJ.

UltraShape Save GLB/OBJ Output Parameters:

file_path

The file_path output parameter is a string that provides the relative path to the saved file from the COMFY_OUTPUT_DIR. This path is crucial for locating the exported file within your file system and can be used to access or share the file with others. It ensures that you have a clear reference to where your exported mesh is stored, facilitating easy retrieval and management.

UltraShape Save GLB/OBJ Usage Tips:

• Ensure that your refined_mesh is fully processed and ready for export to avoid saving incomplete or incorrect data.
• Utilize the output_dir and filename_prefix parameters to organize your files systematically, especially when working on multiple projects or iterations.

UltraShape Save GLB/OBJ Common Errors and Solutions:

Error: "Directory not found"

• Explanation: This error occurs when the specified output_dir does not exist and cannot be created.
• Solution: Ensure that the path specified in output_dir is valid and that you have the necessary permissions to create directories in the specified location.

Error: "Unsupported file format"

• Explanation: This error arises when an unsupported file format is specified in the file_format parameter.
• Solution: Verify that the file_format is one of the supported options: "glb", "obj", "ply", or "stl". Adjust the parameter to a valid format if necessary.