Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

18.2 KB
Raw Blame
<!DOCTYPE html>
<html lang="en">
	<head>
		<script>/* three.ws theme boot — no-flash; runtime in /theme-switcher.js */(function(){try{var m=localStorage.getItem('twx_theme');var l=m==='auto'?(window.matchMedia&&window.matchMedia('(prefers-color-scheme: light)').matches):m==='light';document.documentElement.setAttribute('data-theme',l?'light':'dark');}catch(e){document.documentElement.setAttribute('data-theme','dark');}})();</script>
		<meta charset="UTF-8" />
		<link rel="icon" href="/favicon.ico" sizes="any" />
		<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
		<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png" />
		<link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png" />
		<link rel="apple-touch-icon" href="/apple-touch-icon.png" />
		<link rel="manifest" href="/manifest.webmanifest" />
		<meta name="viewport" content="width=device-width, initial-scale=1.0" />
		<title data-i18n="segment.meta_title">Parts Studio · Segment a 3D model · three.ws</title>
		<meta
			name="description"
			content="Split any 3D model into meaningful, separable parts — head, torso, limbs; body, wheels, glass. Click a part to isolate it, toggle visibility, and export it on its own as GLB."
		 data-i18n-attr="content:segment.meta_description"/>
		<meta property="og:title" content="Parts Studio — Segment a 3D model · three.ws"  data-i18n-attr="content:segment.meta_og_title"/>
		<meta
			property="og:description"
			content="Turn a single mesh into addressable, named parts you can hide, recolour, replace, and export individually."
		 data-i18n-attr="content:segment.meta_og_description"/>
		<meta property="og:type" content="website" />
	<meta property="og:site_name" content="three.ws" />
	<meta property="og:url" content="https://three.ws/segment" />
	<meta property="og:image" content="https://three.ws/og-image.png" />
	<meta property="og:image:width" content="1200" />
	<meta property="og:image:height" content="630" />
	<meta name="twitter:card" content="summary_large_image" />
	<meta name="twitter:site" content="@trythreews" />
	<meta name="twitter:title" content="Parts Studio · Segment a 3D model · three.ws"  data-i18n-attr="content:segment.meta_twitter_title"/>
	<meta name="twitter:description" content="Segment and isolate parts of any 3D model. Extract, label, and export components for use in your avatar or world."  data-i18n-attr="content:segment.meta_twitter_description"/>
	<meta name="twitter:image" content="https://three.ws/og-image.png" />
		<link rel="stylesheet" href="/style.css" />
		<style>
			.seg-main {
				max-width: 1280px;
				margin: 0 auto;
				padding: var(--space-xl) var(--space-md) var(--space-2xl);
			}
			.seg-head {
				/* Reset the global site-nav `header` rule from style.css —
				   this is an in-page hero, not the top bar. */
				display: block;
				height: auto;
				padding: 0;
				background: none;
				backdrop-filter: none;
				-webkit-backdrop-filter: none;
				border-bottom: 0;
				overflow: visible;
				white-space: normal;
				line-height: var(--leading-normal);
				z-index: auto;
				-webkit-app-region: no-drag;
				text-align: center;
				margin-bottom: var(--space-lg);
			}
			.seg-eyebrow {
				display: inline-flex;
				align-items: center;
				gap: 0.45rem;
				font-family: var(--font-mono);
				font-size: var(--text-xs);
				letter-spacing: 0.16em;
				text-transform: uppercase;
				color: var(--ink-dim);
				border: 1px solid var(--stroke);
				border-radius: 999px;
				padding: 0.3rem 0.7rem;
			}
			.seg-eyebrow::before {
				content: '';
				width: 6px;
				height: 6px;
				border-radius: 50%;
				background: var(--success);
				box-shadow: 0 0 8px var(--success);
			}
			.seg-head h1 {
				display: block;
				color: var(--ink);
				font-family: var(--font-display);
				font-size: clamp(2rem, 5vw, var(--text-2xl));
				line-height: var(--leading-tight);
				margin: var(--space-md) 0 var(--space-xs);
			}
			.seg-head p {
				color: var(--ink-dim);
				max-width: 52ch;
				margin: 0 auto;
				line-height: var(--leading-normal);
			}

			/* Composer ----------------------------------------------------- */
			.composer {
				background: var(--surface-glass);
				border: 1px solid var(--stroke-strong);
				border-radius: var(--radius-lg);
				padding: var(--space-md);
				box-shadow: 0 24px 60px -30px rgba(0, 0, 0, 0.8);
				display: grid;
				grid-template-columns: 1fr auto auto auto;
				gap: var(--space-sm);
				align-items: end;
			}
			@media (max-width: 760px) {
				.composer {
					grid-template-columns: 1fr 1fr;
				}
				.composer .field-url {
					grid-column: 1 / -1;
				}
				.composer .btn {
					grid-column: 1 / -1;
					justify-content: center;
				}
			}
			.field {
				display: flex;
				flex-direction: column;
				gap: 0.3rem;
				min-width: 0;
			}
			.field label {
				font-family: var(--font-mono);
				font-size: var(--text-xs);
				letter-spacing: 0.08em;
				text-transform: uppercase;
				color: var(--ink-dim);
			}
			.field input,
			.field select {
				background: var(--surface-1);
				border: 1px solid var(--stroke);
				border-radius: var(--radius-md);
				color: var(--ink);
				font-family: var(--font-body);
				font-size: var(--text-base);
				padding: 0.6rem 0.7rem;
				outline: none;
				transition: border-color var(--duration-fast), box-shadow var(--duration-fast);
			}
			.field input:focus,
			.field select:focus {
				border-color: var(--accent);
				box-shadow: 0 0 0 3px var(--accent-soft);
			}
			.field input[type='number'] {
				width: 6.5rem;
			}
			.btn {
				display: inline-flex;
				align-items: center;
				gap: 0.5rem;
				font-family: var(--font-display);
				font-weight: 600;
				font-size: var(--text-base);
				color: #0b0b0b;
				background: var(--accent);
				border: 1px solid var(--accent);
				border-radius: var(--radius-md);
				padding: 0.62rem 1.2rem;
				cursor: pointer;
				transition: transform var(--duration-fast) var(--ease-standard), opacity var(--duration-fast), box-shadow var(--duration-fast);
			}
			.btn:hover {
				box-shadow: 0 0 0 4px var(--accent-soft);
			}
			.btn:active {
				transform: translateY(1px);
			}
			.btn[disabled] {
				opacity: 0.45;
				cursor: not-allowed;
			}
			.btn-ghost {
				background: transparent;
				color: var(--ink);
				border: 1px solid var(--stroke-strong);
			}
			.btn-ghost:hover {
				background: var(--surface-2);
				box-shadow: none;
			}
			.btn:focus-visible,
			.icon-btn:focus-visible {
				outline: 2px solid var(--accent);
				outline-offset: 2px;
			}

			/* Stage / states ---------------------------------------------- */
			.stage {
				margin-top: var(--space-lg);
				min-height: 360px;
			}
			.panel {
				background: var(--surface-glass);
				border: 1px solid var(--stroke);
				border-radius: var(--radius-lg);
				overflow: hidden;
			}
			.is-hidden {
				display: none !important;
			}

			/* Loading */
			.loading {
				display: grid;
				place-items: center;
				padding: var(--space-2xl);
				text-align: center;
			}
			.loading .spinner {
				width: 38px;
				height: 38px;
				border-radius: 50%;
				border: 3px solid var(--stroke-strong);
				border-top-color: var(--accent);
				animation: spin 0.8s linear infinite;
				margin-bottom: var(--space-md);
			}
			@keyframes spin {
				to {
					transform: rotate(360deg);
				}
			}
			.loading h3 {
				font-family: var(--font-display);
				margin: 0 0 var(--space-xs);
			}
			.loading p {
				color: var(--ink-dim);
				margin: 0;
			}
			.loading .meta {
				font-family: var(--font-mono);
				font-size: var(--text-xs);
				color: var(--ink-dim);
				margin-top: var(--space-sm);
			}

			/* Result layout: viewport + parts panel */
			.result {
				display: grid;
				grid-template-columns: 1fr 320px;
				min-height: min(70vh, 640px);
			}
			@media (max-width: 880px) {
				.result {
					grid-template-columns: 1fr;
				}
			}
			.viewport-wrap {
				position: relative;
				background: radial-gradient(120% 120% at 50% 0%, #161616 0%, #0b0b0b 70%);
				min-height: 360px;
			}
			.viewport {
				position: absolute;
				inset: 0;
			}
			.viewport-bar {
				position: absolute;
				left: 0;
				right: 0;
				bottom: 0;
				display: flex;
				align-items: center;
				justify-content: space-between;
				gap: var(--space-sm);
				padding: var(--space-sm) var(--space-md);
				background: linear-gradient(to top, rgba(0, 0, 0, 0.6), transparent);
				flex-wrap: wrap;
			}
			.viewport-bar .label {
				font-size: var(--text-sm);
				color: var(--ink);
				font-family: var(--font-mono);
			}
			.viewport-bar .actions {
				display: inline-flex;
				gap: var(--space-xs);
			}
			.tip {
				position: absolute;
				top: var(--space-sm);
				left: var(--space-md);
				font-family: var(--font-mono);
				font-size: var(--text-xs);
				color: var(--ink-dim);
				background: rgba(0, 0, 0, 0.4);
				padding: 0.25rem 0.55rem;
				border-radius: 999px;
				pointer-events: none;
			}

			/* Parts panel */
			.parts {
				border-left: 1px solid var(--stroke);
				display: flex;
				flex-direction: column;
				min-height: 0;
				background: var(--surface-1);
			}
			@media (max-width: 880px) {
				.parts {
					border-left: none;
					border-top: 1px solid var(--stroke);
				}
			}
			.parts-head {
				display: flex;
				align-items: center;
				justify-content: space-between;
				padding: var(--space-sm) var(--space-md);
				border-bottom: 1px solid var(--stroke);
			}
			.parts-head h2 {
				font-family: var(--font-display);
				font-size: var(--text-base);
				margin: 0;
				display: flex;
				align-items: center;
				gap: 0.5rem;
			}
			.parts-head .count {
				font-family: var(--font-mono);
				font-size: var(--text-xs);
				color: var(--ink-dim);
				background: var(--surface-3);
				border-radius: 999px;
				padding: 0.1rem 0.5rem;
			}
			.parts-list {
				overflow-y: auto;
				max-height: min(60vh, 560px);
				padding: var(--space-xs);
				display: flex;
				flex-direction: column;
				gap: 2px;
			}
			.part-row {
				display: flex;
				align-items: center;
				gap: 0.25rem;
				border-radius: var(--radius-md);
				padding: 0.15rem 0.25rem;
				transition: background var(--duration-fast);
			}
			.part-row:hover {
				background: var(--surface-2);
			}
			.part-row.is-selected {
				background: var(--accent-soft);
				box-shadow: inset 0 0 0 1px var(--accent);
			}
			.part-row.is-hidden-part .part-text {
				opacity: 0.4;
			}
			.part-main {
				flex: 1;
				min-width: 0;
				display: flex;
				align-items: center;
				gap: 0.6rem;
				background: transparent;
				border: none;
				color: inherit;
				font: inherit;
				cursor: pointer;
				text-align: left;
				padding: 0.4rem 0.4rem;
				border-radius: var(--radius-sm);
			}
			.swatch {
				width: 14px;
				height: 14px;
				border-radius: 4px;
				flex: none;
				box-shadow: inset 0 0 0 1px rgba(255, 255, 255, 0.2);
			}
			.part-text {
				min-width: 0;
				display: flex;
				flex-direction: column;
				line-height: 1.25;
			}
			.part-name {
				font-size: var(--text-sm);
				color: var(--ink);
				white-space: nowrap;
				overflow: hidden;
				text-overflow: ellipsis;
			}
			.part-sub {
				font-family: var(--font-mono);
				font-size: 0.66rem;
				color: var(--ink-dim);
			}
			.part-actions {
				display: inline-flex;
				gap: 1px;
				flex: none;
			}
			.icon-btn {
				background: transparent;
				border: none;
				color: var(--ink-dim);
				font-size: 0.85rem;
				width: 26px;
				height: 26px;
				border-radius: var(--radius-sm);
				cursor: pointer;
				transition: background var(--duration-fast), color var(--duration-fast);
			}
			.icon-btn:hover {
				background: var(--surface-3);
				color: var(--ink);
			}

			/* Notices (empty/error/unconfigured) */
			.notice {
				padding: var(--space-2xl) var(--space-lg);
				text-align: center;
				color: var(--ink-dim);
			}
			.notice h3 {
				color: var(--ink);
				font-family: var(--font-display);
				margin: 0 0 var(--space-xs);
			}
			.notice.error h3 {
				color: var(--danger);
			}
			.notice p {
				max-width: 52ch;
				margin: 0 auto;
				line-height: var(--leading-normal);
			}
			.notice .glyph {
				font-size: 2.4rem;
				opacity: 0.5;
				display: block;
				margin-bottom: var(--space-sm);
			}
			.notice .actions {
				margin-top: var(--space-md);
				display: inline-flex;
				gap: var(--space-xs);
			}
			.notice code {
				font-family: var(--font-mono);
				font-size: 0.85em;
				background: var(--surface-2);
				padding: 0.1rem 0.35rem;
				border-radius: var(--radius-sm);
			}
			.hint-foot {
				text-align: center;
				color: var(--ink-dim);
				font-size: var(--text-xs);
				margin-top: var(--space-lg);
				line-height: var(--leading-normal);
			}
			.hint-foot a {
				color: var(--ink);
			}
		</style>
	</head>
	<body>
		<div id="nav-container"></div>

		<main class="seg-main">
			<header class="seg-head">
				<span class="seg-eyebrow" data-i18n="segment.parts_segmentation">Parts · segmentation</span>
				<h1 data-i18n="segment.split_a_model_into_parts">Split a model into parts</h1>
				<p data-i18n="segment.paste_a_glb_obj_stl_ply_url">
					Paste a GLB/OBJ/STL/PLY URL. Parts Studio separates it at disconnected shells and
					concave creases into named, recolourable parts — then click any part to isolate it,
					toggle its visibility, or export it on its own.
				</p>
			</header>

			<form class="composer" id="composer" autocomplete="off">
				<div class="field field-url">
					<label for="mesh-url" data-i18n="segment.mesh_url_https">Mesh URL (https)</label>
					<input
						id="mesh-url"
						name="mesh-url"
						type="url"
						inputmode="url"
						placeholder="https://…/model.glb"
						required
					/>
				</div>
				<div class="field">
					<label for="method" data-i18n="segment.method">Method</label>
					<select id="method" name="method">
						<option value="auto" selected data-i18n="segment.auto_shells_creases">Auto (shells + creases)</option>
						<option value="connected" data-i18n="segment.connected_shells">Connected shells</option>
						<option value="crease" data-i18n="segment.concave_creases">Concave creases</option>
					</select>
				</div>
				<div class="field">
					<label for="max-parts" data-i18n="segment.max_parts">Max parts</label>
					<input id="max-parts" name="max-parts" type="number" min="2" max="64" value="24" />
				</div>
				<button class="btn" id="segment-btn" type="submit" data-i18n-html="segment.segment">
					<span id="segment-label">Segment</span>
				</button>
			</form>

			<section class="stage" id="stage" aria-live="polite">
				<!-- Empty -->
				<div class="panel notice" id="state-empty">
					<span class="glyph" aria-hidden="true">⬢</span>
					<h3 data-i18n="segment.nothing_segmented_yet">Nothing segmented yet</h3>
					<p data-i18n-html="segment.paste_a_public_mesh_url_above_and">
						Paste a public mesh URL above and press Segment. Generated a model in
						<a href="/forge">Forge</a>? Open it here with the “Split into parts” button on the
						result, or paste its GLB link.
					</p>
				</div>

				<!-- Loading -->
				<div class="panel loading is-hidden" id="state-loading">
					<div class="spinner" aria-hidden="true"></div>
					<h3 data-i18n="segment.segmenting_your_model">Segmenting your model</h3>
					<p id="loading-note" data-i18n="segment.fetching_and_analysing_the_mesh">Fetching and analysing the mesh…</p>
					<div class="meta" id="loading-meta">Elapsed 0s</div>
					<div style="margin-top: var(--space-md)">
						<button class="btn btn-ghost" type="button" id="cancel" data-i18n="segment.cancel">Cancel</button>
					</div>
				</div>

				<!-- Result -->
				<div class="panel result is-hidden" id="state-result">
					<div class="viewport-wrap">
						<div class="viewport" id="viewport"></div>
						<span class="tip" aria-hidden="true" data-i18n="segment.drag_to_orbit_click_a_part_to">Drag to orbit · click a part to select</span>
						<div class="viewport-bar">
							<span class="label" id="selection-label" data-i18n="segment.click_a_part_to_inspect">click a part to inspect</span>
							<div class="actions">
								<button class="btn btn-ghost" type="button" id="reset-view" data-i18n="segment.reset_view">Reset view</button>
								<button class="btn btn-ghost" type="button" id="show-all" data-i18n="segment.show_all">Show all</button>
								<a class="btn btn-ghost" id="download-glb" download data-i18n="segment.download_glb">Download GLB</a>
							</div>
						</div>
					</div>
					<aside class="parts" aria-label="Parts">
						<div class="parts-head">
							<h2 data-i18n-html="segment.parts_0">Parts <span class="count" id="parts-count">0</span></h2>
						</div>
						<div class="parts-list" id="parts-list" role="list"></div>
					</aside>
				</div>

				<!-- Error -->
				<div class="panel notice error is-hidden" id="state-error">
					<span class="glyph" aria-hidden="true">⚠</span>
					<h3 data-i18n="segment.segmentation_failed">Segmentation failed</h3>
					<p id="error-message" data-i18n="segment.something_went_wrong_try_a_simpler_mesh">Something went wrong. Try a simpler mesh or fewer parts.</p>
					<div class="actions">
						<button class="btn" type="button" id="retry" data-i18n="segment.try_again">Try again</button>
					</div>
				</div>

				<!-- Unconfigured -->
				<div class="panel notice is-hidden" id="state-unconfigured">
					<span class="glyph" aria-hidden="true">◌</span>
					<h3 data-i18n="segment.segmenter_not_configured">Segmenter not configured</h3>
					<p data-i18n-html="segment.part_segmentation_needs_the_segment_worker_d">
						Part segmentation needs the segment worker deployed. Once
						<code>GCP_SEGMENT_URL</code> and <code>GCP_RECONSTRUCTION_KEY</code> are set, this
						page runs the full pipeline with no further changes.
					</p>
				</div>
			</section>

			<p class="hint-foot" data-i18n-html="segment.geometry_based_segmentation_disconnected_she">
				Geometry-based segmentation — disconnected shells plus the minima rule (cut at concave
				creases). Each part becomes a named node in the output GLB. The same tool is available to
				agents over MCP as <code>segment_model</code> and over REST at
				<a href="/docs">/api/forge-segment</a>.
			</p>
		</main>

		<script src="/nav.js" defer></script>
		<script type="module" src="/src/segment.js"></script>
		<div id="footer-container"></div>
		<script src="/footer.js"></script>
		<!-- Runtime i18n: detects locale, swaps annotated copy, mounts <lang-switcher>. -->
	<script type="module" src="/i18n.js"></script>
</body>
</html>