Skip to content

Latest commit

 

History

History
208 lines (172 loc) · 14 KB

DESIGN.md

File metadata and controls

208 lines (172 loc) · 14 KB

Blind interface system

1. Visual theme and atmosphere

Blind is a quiet engineering inspection surface. The mesh is the only visual anchor; controls recede into graphite or soft gray planes with one restrained blue accent.

2. Color palette and roles

  • Canvas dark: oklch(0.22 0.008 255)
  • Canvas light: oklch(0.93 0.008 250)
  • Elevated dark: oklch(0.27 0.009 255)
  • Text dark: oklch(0.91 0.008 255)
  • Text light: oklch(0.25 0.009 255)
  • Accent: oklch(0.70 0.14 250)
  • Danger: oklch(0.67 0.15 28)

The 60-30-10 ratio controls visual weight. It is not explained in product copy.

3. Typography

Use the native San Francisco family with PingFang SC fallback. Blind is a dense tool, not a display surface. UI text runs from 11 to 16px, with tabular numbers for counts and percentages.

4. Components

Buttons use a 10px radius and 42px minimum hit target. The bottom dock uses a 16px outer radius. Press feedback is a 0.96 scale. The share action opens a focused action sheet with three explicit outputs. Brush mode replaces the dock with a compact color-and-action tool strip; its ink uses a 4.25px round stroke over a restrained 7px separation edge.

5. Layout

The canvas is full bleed. On phones, the bottom dock remains persistent while a docked sheet changes the usable 3D viewport. On landscape and desktop, settings move to a 340px right sheet.

The scene tree and annotation list share an upper-right stack bounded by the viewport and bottom tools. The annotation list reserves up to 45% of that height; the scene tree shrinks into the remaining space. Their headers stay visible and each list scrolls independently. Long lists never push either pane offscreen. The scene tree floats over the canvas without reserving a column or painting a full-height background. Its height follows its content up to the space above the bottom dock, capped at 65dvh. Its opaque backing is lighter than the canvas, with a fine outline and soft shadow to establish a floating surface. It occludes geometry and labels without text shadows or individual text backgrounds. Only the list scrolls; its heading stays visible. Long names wrap, and selection uses accent text with a quiet neutral row tint. Opening or closing the tree never resizes the canvas. Do not show a direction orb or view menu. Keep Show All and Hide All above the scrolling list. Double-clicking an element shows and focuses it while hiding every other element across all groups and types. Visibility changes preserve nonzero opacity; showing a fully transparent element restores its opacity so it is actually visible. These states travel with shares. Inset the scrolling list from the rounded pane edge. Fade only edges with more content offscreen; remove the fade at each scroll limit so the first and last rows remain fully readable. Keep the header and global actions outside the fade.

Scene information is hidden by default and opens in the scene tree's 信息 tab. The main dock contains 适配、观察、标注、分享. 观察 replaces it with a second toolbar ordered as 着色、光照、投影、场景、剖面, with a compact return control. The first four entries expand their controls in the same dock; 剖面 starts the line gesture immediately. 场景 contains axes and background switches; raking light exposes its three controls only when selected. No separate display panel or duplicate lighting selector is used. The toolbars crossfade and translate; reduced-motion settings remove the transition. Both fit at 320px. Icons come from Lucide. Scene messages wrap and scroll in the 信息 tab. Each scene row places a rename action directly after its label. Long names show their beginning and end in the row and on the 3D label. The 信息 tab reveals a bounded, scrollable full name; the inline editor keeps the entire value available. Selected-entity details and Mesh Raw/LOD quality live in the 信息 tab.

An entity is one placed instance of a component. Every entity has an identity, label, group, placement, visibility and opacity. The scene tree provides a flat opacity slider and visibility button on each entity row. Geometry rows show their current color before the name and expand preset choices below the row. The details sheet keeps labels and type-specific settings. Sharing and focus use the same contract for Mesh, PTS, text, JSON, images and plugins. Geometric components use the existing 3D renderer without a content surface frame. They add geometry-specific controls such as quality and color. Surface components keep their content frame. A reviewer can rename or hide any entity; changing either property leaves the source file untouched.

The section tool belongs to observation. It starts from the selected, visible triangle Mesh; PTS and point clouds have no section surface. Clicking 剖面 immediately enters a touch or pointer line gesture to establish a plane through the selected Mesh. The position slider scans parallel planes. The line length provides a fallback 2D window radius, while the initial view fits the complete contour. Intersection uses the complete selected Mesh. The closed contour is filled with a translucent matte plane over the selected Mesh; the view tilts slightly to reveal an edge-on plane. Open contours remain lines. The plot supports zoom, drag to pan, fit, and a two-line ruler with screen-distance contour snapping and an optional distance to an opposite contour. The opposite search excludes the picked contour's nearby arc and rejects tangential candidates, following AutoCrown's geometry rule. Its distance limit scales with the picked contour because Blind's Meshes have no declared physical unit. All selected Meshes can contribute to an inter-Mesh gap; unselected Meshes cannot. Mouse right or middle drag pans while measuring; touch uses two fingers to pan and pinch. The panel can be resized from its upper-left handle. The plot window, panel size, and measurements travel with view and image links; measurements are in source mesh coordinates because generic mesh files do not declare a physical unit. Changing the plane or target set clears old measurements. The selected Mesh anchors the drawn plane. Every visible triangle Mesh is a section target by default; the compact count opens a picker to isolate any subset. Each target has a distinct contour and translucent cap in its Mesh color. Hidden or unselected Meshes do not contribute. A selected Mesh that misses the plane is marked in the picker. The reviewer may also remove the initial Mesh while keeping another target. Changing the target set fits and centers all selected contours in the plot. Sharing records the plane and every target's entity ID and source revision so a reopened link shows the same combination. On touch screens, the section panel yields the canvas while a line is drawn and returns when the gesture ends.

Labels share one visual grammar. A one-Mesh label uses a leader and attachment dot, with short leaders placed near their attachments instead of beyond Mesh bounding boxes. Ordinary labels and their leaders sit behind geometry; only labels for the selected Mesh sit in front. A group caption interrupts the edge of a restrained corner frame around its projected union, without a separate card or leader. Its type stays at 11px even on narrow screens. The frame never fills or tints the geometry, and selecting its caption fits the whole group. Group captions identify their members; only the selected member expands its individual label, omitting an exact repeated group prefix. The selected Mesh gets placement priority. Other captions appear only where they fit without overlapping labels or controls; camera movement rechecks cached placements. Full Mesh names remain available in the detail panel.

6. Depth

Depth comes from background lightness steps and restrained shadows. No blur glass, decorative gradients, or hard card outlines.

7. Guardrails

  • Never show Solo.
  • Never put the selected mesh name in the global dock.
  • Do not narrate palette decisions in UI copy.
  • Do not bind product language to a network vendor.
  • Observation tools never alter source geometry.
  • Do not use pure black or pure white.
  • Keep view, image, and full-info sharing as separate choices.
  • Brush mode must fully intercept pointer input so drawing never rotates the scene.
  • Screen markup must disappear as soon as camera framing changes.

8. Responsive behavior

Phone mesh sheets use content height up to 52dvh. Style sheets snap to 44dvh and 82dvh. Content scroll begins only at the expanded detent. Landscape and widths above 760px use a right sheet. Safe-area insets are respected. Below 360px, the brush strip becomes two compact rows so every target remains at least 40px.

9. Agent prompt guide

  • "Add an icon action using a 42px hit area, 10px radius, graphite surface, and 0.96 press scale."
  • "Add a mobile sheet using 44dvh and 82dvh detents, 16px top radius, no blur, and a 48px drag header."
  • "Add a selected row using only an accent dot and surface lightness step, without a decorative side rail."
  • "Add a screen-markup action using a pointer-blocking canvas, 3.2px round ink, a subtle 3.8px separation edge, four high-contrast colors, and a compact two-row layout below 360px."

Surface annotation interaction

The annotation action opens one selection, point, line and screen-brush dock, with screen brush active by default. Keep two persistent tool rows; reveal the color palette on demand and name/line controls only for a selected mark. Newly created points and completed lines stay selected so their name field remains editable. Never autofocus a phone keyboard. Do not expose a target-Mesh picker: the nearest visible hit determines ownership. Release a dragged stroke to finish it; the next stroke naturally creates another. Only click-to-connect drafts need an explicit Finish Line action.

The separate annotation list covers all visible Meshes and screen strokes. Canvas numbers match list rows. Open the list by default when a shared scene contains annotations, without entering drawing mode. Selecting a row highlights the mark and brings obscured surface marks into view. A compact sheet above the dock on phones and a right panel on desktop keep the mesh primary. All actions retain 42px touch targets. Opening tools and lists never resizes the scene canvas. Scene information lives in the tree and does not hide the annotation list or canvas badges.

Use the shared 3.2px ink width for screen and surface lines. Surface ribbons lie on local tangent planes, avoiding clipping on slopes. Do not add tube lighting, gloss, glow or heavy dark outlines. Only selections show pale emphasis and handles. Smooth curves are sampled onto the visible surface; invalid smoothing preserves the valid path. Never refit a shared path on load. Camera navigation is explicit; interrupted touches roll back the current surface gesture. Screen strokes retain their view-dependent behavior, with shared undo history cleared of obsolete views.

Screen brush strokes support the same editable names as surface marks; names survive undo, sharing, reopening, and PNG export. Unnamed strokes keep their numbered fallback.

Component positions are fixed during review, including meshes, images, text and plugin surfaces. Native document bodies own reading, selection and content marking; title and blank-scene drags navigate the camera. Opaque HTML/plugin previews retain scene gestures until expanded. There are no position drag handles or Alt/arrow movement shortcuts. Explicit positions and automatic initial layout remain part of scene loading.

Spatial content keeps its native DOM opacity. Parallel XY content planes interleave with GPU-clipped geometry bands, copied through one WebGL renderer into canvas layers. Empty bands allocate no bitmap; hidden content stays connected to preserve plugin state. Pointer routing tests painted geometry coverage, including wireframe gaps, and preserves the full pointer lifecycle for mesh selection.

Planar-only scenes use an affine DOM board, not a camera-locked 3D view. Structural mode selection includes hidden world entities and excludes fixed panels. Board navigation never creates WebGL, Arcball or CSS3D objects. Zoom counter-scales only screen-sized chrome; it does not reflow native source content or recapture reading anchors. Layout-changing operations settle reading before returning or admitting new screen ink.

Fixed panel placement is separate from world layout and focus/fullscreen presentation. Panels retain input ownership during navigation. Their measured width reserves usable viewport and scene-control space; scene trees and observation panels must not cover a controller.

UI, plugins and Collection share typed semantic operations and domain state, with render adapters below and transports above. Catalogs expose concrete schemas, permission and availability. Private ports bind identity/grants; content inspection is own-entity by default. Queries stay pure, IDs remain stable, unavailable actions fail explicitly, and disposal removes subscriptions and pending calls.

Native content uses one DOM/SVG reading surface across spatial, focus and fullscreen. A 42px name row carries only fullscreen and overflow actions; selection, source-bound marks, zoom and actual diagram groups are contextual. Reading uses source-versioned line/block/pointer anchors, not copied scrollTop values. Content marks use text offsets or original visual coordinates and are separate from view-dependent screen ink. Collections use full-bleed panes, 1px dividers and overlaid names. Each pane has a 42px top-right expand/restore button; an expanded scene fills the viewing area and top-left tabs switch between the mounted scenes. Restore returns to the responsive split layout; narrow screens also use tabs. Inactive scenes retain their last viewport size and independent state. Single-scene viewers have neither collection tabs nor pane expand/restore buttons.

Global fit and mesh/component focus reset zoom and lens framing while preserving the current viewing direction and roll. Orthographic fit uses bounds projected onto the current camera axes, so rotated geometry fits the same way after either zooming in or out. New camera gestures cancel an unfinished fit transition.