ComfyUI > Nodes > ComfyUI libigl > Self Intersections

ComfyUI Node: Self Intersections

Class Name

GeomPackDetectSelfIntersections

Category
geompack/repair
Author
PozzettiAndrea (Account age: 2240days)
Extension
ComfyUI libigl
Latest Updated
2025-12-22
Github Stars
0.06K

How to Install ComfyUI libigl

Install this extension via the ComfyUI Manager by searching for ComfyUI libigl
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI libigl in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

Self Intersections Description

Detects self-intersecting faces in 3D meshes using libigl and CGAL for quality assurance.

Self Intersections:

The GeomPackDetectSelfIntersections node is designed to identify self-intersecting faces within a 3D mesh, a crucial step in ensuring mesh quality before engaging in operations like boolean modifications or 3D printing. This node leverages advanced computational geometry techniques, specifically utilizing the libigl library with CGAL, to robustly detect intersections without altering the original mesh. By analyzing the mesh, it creates scalar fields that visually indicate which faces and vertices are involved in self-intersections, providing a clear and informative visualization of potential issues. This capability is essential for artists and designers who need to ensure the integrity and quality of their 3D models, as self-intersections can lead to errors in downstream processes.

Self Intersections Input Parameters:

trimesh

The trimesh parameter is the primary input for the GeomPackDetectSelfIntersections node, representing the 3D mesh that you wish to analyze for self-intersections. This parameter requires a mesh in the TRIMESH format, which typically includes vertices and faces that define the geometry of the model. The function of this parameter is to provide the node with the necessary data to perform intersection detection. The quality and complexity of the input mesh can impact the node's execution time and results, as more complex meshes may contain more potential intersections to analyze. There are no specific minimum, maximum, or default values for this parameter, as it depends on the mesh you are working with.

Self Intersections Output Parameters:

mesh_with_field

The mesh_with_field output parameter provides the original mesh augmented with additional attributes that indicate self-intersections. This enhanced mesh includes scalar fields on faces and vertices that visually represent which parts of the mesh are involved in intersections. This output is crucial for users who need to visually inspect and address self-intersections in their models, ensuring that the mesh is suitable for further processing or printing.

report

The report output parameter is a string that summarizes the results of the intersection detection process. It provides a concise overview of the findings, such as the number of intersecting faces or any issues encountered during the analysis. This report is valuable for users who need a quick assessment of the mesh's quality and any potential problems that need to be addressed.

Self Intersections Usage Tips:

  • Ensure that your input mesh is in the correct TRIMESH format to avoid compatibility issues and to ensure accurate intersection detection.
  • Use the scalar fields in the mesh_with_field output to visually inspect and identify problematic areas in your mesh, allowing for targeted corrections.
  • Regularly check for self-intersections in your mesh, especially before performing boolean operations or preparing the model for 3D printing, to prevent errors in these processes.

Self Intersections Common Errors and Solutions:

[DetectSelfIntersections] CGAL detection failed: <error_message>

  • Explanation: This error indicates that the CGAL-based detection method encountered an issue, possibly due to the complexity or specific characteristics of the input mesh.
  • Solution: Verify that your mesh is correctly formatted and does not contain any anomalies that could interfere with the detection process. Consider simplifying the mesh or using a different method to preprocess it before running the node again.

[DetectSelfIntersections] Falling back to zero fields (CGAL error)

  • Explanation: This message appears when the node fails to detect intersections using the CGAL method and defaults to a basic method that does not modify the mesh.
  • Solution: While this fallback ensures that the process completes, it may not provide the most accurate results. Review the input mesh for potential issues and try running the node again, or consider using alternative tools for intersection detection if the problem persists.

Self Intersections Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI libigl
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.