Nodes/ComfyUI libigl/Preview Gaussian
ComfyUI Node

Preview Gaussian

Actually look at a gaussian splat before you build on it

By PozzettiAndrea·Created 10 months ago·Updated 4 days ago· 218
Preview Gaussian
  • extrinsics
  • intrinsics
    ply_path

    Gaussian splatting files are the new normal in the 3D capture world, and if you've downloaded a .ply that turns out to be one, you need a way to actually see it. ComfyUI's built-in image preview will not help - that's a point-cloud-in-spirit render, not a regular image. This node is the pack's splat viewer: point it at a gaussian-splat PLY file and it opens an interactive viewer so you can spin the scene around before you do anything with it.

    The one required input is ply_path - a path to a gaussian splatting .ply file. That's it. There are no geometry outputs, because this is a visualization node: its job is to make you see the splat, not to transform it. The rendering is handled by the pack's comfy-3d-viewers dependency, which is where the Three.js-based interactive preview comes from.

    Two optional camera inputs complete it:

    • extrinsics - a 4x4 camera extrinsics matrix that sets the initial view. If you have a camera node in your graph that outputs this, you can start the preview from that exact angle.
    • intrinsics - the 3x3 intrinsics matrix, which controls the field of view the preview opens with.

    Both are optional and both come from compatible camera/pose nodes in the wider ComfyUI 3D ecosystem - if you don't have them, the viewer just opens at a default camera. For a beginner this is the nice part: you can ignore them completely and still get a working look at your splat.

    Where it fits

    It's the sanity-check node for anything gaussian-based. Before you spend time meshing, sampling, or analyzing a splat, a five-second spin-around tells you whether the capture is even usable - how much geometry is actually there, whether the splats are noisy, whether the scene is what you expected. It's also the pack's bridge into the ComfyUI 3D world: the Comfy3D community Discord the README points to is where the gaussian and 3D-asset workflows live, and this node is your on-ramp for eyeballing their outputs.

    Install

    Standard pack install:

    cd ComfyUI/custom_nodes
    git clone https://github.com/PozzettiAndrea/ComfyUI-GeometryPack.git
    cd ComfyUI-GeometryPack
    pip install -r requirements.txt --upgrade
    python install.py
    

    Or ComfyUI Manager → GeometryPack. Usual caveats: experimental comfy-env/pixi install with a heavy first download, and a fast-moving repo where the author takes reports in Discussions. If the viewer never opens or errors on load, that's the classic "bundled viewer dependency didn't finish installing" situation - restart ComfyUI once before blaming the file.

    Watch out

    A splat PLY is not the same as a mesh PLY. Feed a regular triangle-mesh PLY into this node and it won't render as a splat - the loader expects gaussian splat data (positions, covariances, colors). If nothing shows, double-check what your file actually is before assuming the node is broken. And don't expect output wires: this node previews, and if you want to convert the splat into something you can process, you'll need the mesh/point-cloud side of the pack, not this viewer.

    Categorygeompack/visualization

    Inputs (3)

    NameTypeDefaultDescription
    ply_pathSTRINGPath to a Gaussian Splatting PLY file
    extrinsicsoptEXTRINSICS4x4 camera extrinsics matrix for initial view
    intrinsicsoptINTRINSICS3x3 camera intrinsics matrix for FOV

    Outputs (0)

    No outputs