-
Tip: Default material color is sky-400. Try toon or depth for stylized thumbs.
+
+
Tip: Default material color is sky-400 with per-face lambert shading.
@@ -620,15 +482,6 @@ async def api_thumbnail(
bg: str = Form("#111827"),
edge_alpha: float = Form(0.12),
transparent: Optional[str] = Form(None),
- color: str = Form("#38bdf8"),
- shading: str = Form("lambert"),
- ambient: float = Form(0.20),
- diffuse: float = Form(0.80),
- lx: float = Form(0.577),
- ly: float = Form(0.577),
- lz: float = Form(0.577),
- toon_levels: int = Form(4),
- proj: str = Form("persp"),
):
# Persist incoming file to temp
data = await stl.read()
@@ -643,22 +496,15 @@ async def api_thumbnail(
bg=bg,
transparent=bool(transparent),
edge_alpha=edge_alpha,
- color=color,
- shading=shading,
- ambient=ambient,
- diffuse=diffuse,
- light_dir=(lx, ly, lz),
- toon_levels=toon_levels,
- proj=proj,
)
try:
png = render_stl_to_png_bytes(tmp_path, params)
except Exception as e:
return HTMLResponse(
- f'
'
+ f'
'
f"
Render failed
"
- f"
{e}"
+ f"
{typer.style(str(e), fg=typer.colors.RED)}"
f"
",
status_code=400,
)
@@ -674,20 +520,87 @@ async def api_thumbnail(
b64 = base64.b64encode(png).decode("ascii")
html = f"""
-
-
-
![\"thumbnail\"/](\"data:image/png;base64,{b64}\")
+
+
+
-
-
Download PNG (#{rec_id})
-
|
-
Size: {len(png)} bytes
+
+
Download PNG (#{rec_id})
+
|
+
Size: {len(png)} bytes
"""
return HTMLResponse(html)
+# ---------- TUI (Textual) ----------
+@cli.command("tui")
+def cli_tui(
+ stl: Path = typer.Argument(
+ ..., exists=True, readable=True, help="Input .stl file to preview"
+ ),
+):
+ """Render and preview a thumbnail in your terminal (Textual)."""
+ # Lazy import textual so basic CLI doesn't pull it in if not needed
+ from textual.app import App, ComposeResult
+ from textual.widgets import Header, Footer, Static
+ from textual.containers import Vertical
+
+ try:
+ from textual.widgets import Image as TImage # textual >= 0.45
+
+ HAS_IMAGE = True
+ except Exception:
+ HAS_IMAGE = False
+
+ class ThumbApp(App):
+ CSS = """
+ Screen { background: #0b1220; }
+ #wrap { align: center middle; height: 100%; }
+ """
+
+ def __init__(self, stl_path: Path):
+ super().__init__()
+ self.stl_path = stl_path
+ self.png_bytes: Optional[bytes] = None
+
+ def compose(self) -> ComposeResult:
+ yield Header(show_clock=True)
+ yield Vertical(Static("Rendering thumbnail...", id="status"), id="wrap")
+ yield Footer()
+
+ def on_mount(self) -> None:
+ # Render in background thread to avoid blocking UI
+ def _do_render():
+ params = RenderParams(
+ width=700,
+ height=500,
+ elev=22,
+ azim=45,
+ bg="#0b1220",
+ transparent=False,
+ edge_alpha=0.08,
+ )
+ self.png_bytes = render_stl_to_png_bytes(self.stl_path, params)
+ self.call_from_thread(self._show_image)
+
+ self.run_worker(_do_render, exclusive=True)
+
+ def _show_image(self):
+ self.query_one("#status", Static).update(
+ f"[b]{self.stl_path.name}[/b] • {len(self.png_bytes or b'')} bytes"
+ )
+ if self.png_bytes and HAS_IMAGE:
+ # Save to tmp and display
+ tmp = Path(f"/tmp/{int(time.time() * 1000)}_{self.stl_path.stem}.png")
+ tmp.write_bytes(self.png_bytes)
+ img = TImage.from_path(tmp)
+ self.query_one("#wrap", Vertical).mount(img)
+
+ ThumbApp(stl).run()
+
+
# ---------- Entrypoint ----------
def _maybe_run_cli_or_server():
# If uvicorn is exec-ing this, avoid double-running CLI