gradio_sync3dcompare

Synchronized side-by-side 3D comparison viewer for Gradio — supports PLY and GLB files with shared camera control.

Installation

pip install gradio_sync3dcompare

Usage

import gradio as gr
from gradio_sync3dcompare import Sync3DCompare


with gr.Blocks(title="Sync3DCompare Demo") as demo:
    gr.Markdown("# Sync3DCompare — Synchronized 3D Comparison Viewer")
    gr.Markdown(
        "Compare two 3D assets side-by-side with synchronized orbit, pan, and zoom. "
        "Rotate one view and all others follow."
    )
    gr.Markdown(
        "### Two synchronized viewports. Upload `.ply` or `.glb` files manually into each pane."
    )
    Sync3DCompare(
        label="Two-Viewport 3D Comparison",
        value=[],
        render_mode="points",
        sync_camera=True,
        point_size_mode="auto",
        point_size=1.0,
        height=540,
        max_views=2,
    )


if __name__ == "__main__":
    demo.launch(ssr_mode=False)

Sync3DCompare

Initialization

list[dict]| None

str| None

"points"| "native"

bool

"auto"| "manual"

float

float

float

float

float

int

int

int| None

bool

bool

str| None

list[str]| str| None

bool

Events

User function

The impact on the users predict function varies depending on whether the component is used as an input or output for an event (or both).

• When used as an Input, the component only impacts the input signature of the user function.
• When used as an output, the component only impacts the return signature of the user function.

The code snippet below is accurate in cases where the component is used as both an input and an output.

• As input: Should return, the output data received by the component from the user's function in the backend.

def predict(
    value: Unknown
) -> list[dict]| None:
    return value